---
title: "Advertisers"
slug: "advertisers"
updated: 2026-05-26T13:20:47Z
published: 2026-05-26T13:20:47Z
canonical: "help.yahooinc.com/advertisers"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.yahooinc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Advertisers

*This article describes services for reading, adding, and updating advertisers.*

## Overview

A direct advertiser is a company that lists advertisements on Yahoo DSP to purchase inventory provided by a range of publishers in the broader marketplace. A seat holder manages direct advertisers.

## Endpoint

```plaintext
/traffic/advertisers
```

The action taken depends on the HTTP method and the parameters specified.

- Use the `GET` method to read an existing advertiser.
- Use the `POST` method to create a new advertiser.
- Use the `PUT` method to update an existing advertiser.

## Resources

### Advertiser Object

The `advertisers` resource is defined by the following following fields:

| **Name** | **Description** | **Type** | **Create** | **Update** |
| --- | --- | --- | --- | --- |
| `id` | Specifies the advertiser ID. | `integer` | N/A | Required |
| `name` | Specifies the name of the advertiser. | `string` | Required | Optional |
| `status` | Specifies the current status of the advertiser. Options include: - If `ACTIVE`, the advertiser is active. - If `INACTIVE`, the advertiser is inactive. - If `ARCHIVED`, the advertiser is archived. | `string` | Required | Optional |
| `landingPageUrl` | Specifies the advertiser’s website URL. | `string` | Required | Optional |
| `iabCategoryId` | Specifies the primary category of the advertiser’s business. Use the `id` field from the [IAB Taxonomy Categories](/dsp-api/docs/data-dictionary#iab-taxonomy-categories) response where the `type` field is set to `PRIMARY`. | `integer` | Required | Optional |
| `iabSecondaryCategoryId` | Specifies a secondary category of the advertiser’s business. Use the `id` field from the [IAB Taxonomy Categories](/dsp-api/docs/data-dictionary#iab-taxonomy-categories) response where the `type` field is set to `SECONDARY`. | `integer` | Optional | Optional |
| `timezone` | Specifies the default time zone for the advertiser’s data; the time zone used to aggregate advertiser data in reports. Use the `tzId` field from the [Timezones](/dsp-api/docs/data-dictionary#timezones) response. Some example values: `America/New_York`, `Etc/GMT`. | `string` | Required | N/A |
| `currency` | Specifies the default currency for the advertiser’s data. Use the code field from the [Currency Types](/dsp-api/docs/data-dictionary#currency-types) response. For example, `USD`, `CAD`. | `string` | Required | N/A |
| `billingPrice` | Specifies the advertiser’s percentage profit margin expressed as a value between 0 and 100. | `number` | Required | Optional |
| `contact` | Specifies the advertiser’s primary contact information. To learn more, refer to [Contact Object](/dsp-api/docs/advertisers#contact-object). | `object` | Required | N/A |
| `billingContact` | Specifies the advertiser’s billing contact information. Billing contact fields are only included in the response for certain seats. To learn more, refer to [Billing Contact Object](/dsp-api/docs/advertisers#billing-contact-object). | `object` | Optional | N/A |
| `isCrossdeviceOff` | Enable or disable the optimization using cross device conversions. By default, `false`. - If `true`, does not track cross-device conversions. For example, if you validate conversions with vendors that cannot track mobile conversions, you may want to disable cross-device conversions. - If `false`, tracks and reports on conversions that take place across multiple devices. For example, if an impression is served to a user’s mobile device, but that user ends up converting and completing a purchase for the advertised product on their desktop, it is considered a cross-device conversion. | `boolean` | Optional | Optional |
| `createdAt` | Read-only field that specifies the time when Advertiser was created. | `string` | N/A | N/A |
| `updatedAt` | Read-only field that specifies the time of the last update. | `string` | N/A | N/A |
| `mdmId` | Read-only field that specifies the MDM ID of the Advertiser. | `integer` | N/A | N/A |

### Contact Object

The `contact` object contains the following fields:

| **Name** | **Description** | **Type** | **Add** | **Update** |
| --- | --- | --- | --- | --- |
| `firstName` | Specifies the first name of the contact. | `string` | Optional | Optional |
| `lastName` | Specifies the last name of the contact. | `string` | Optional | Optional |
| `addressLine1` | Specifies the first line of contact information. | `string` | Required | Optional |
| `addressLine2` | Specifies the second line of contact information. | `string` | Optional | Optional |
| `city` | Specifies the contact’s city. | `string` | Required | Optional |
| `region` | Specifies the contact’s region or state. | `string` | Required | Optional |
| `postalCode` | Specifies the contact’s postal code. | `string` | Optional | Optional |
| `country` | Specifies the contact’s country. | `string` | Required | Optional |
| `telephone` | Specifies the contact’s telephone number. | `string` | Optional | Optional |
| `email` | Specifies the email address of the advertiser contact. | `string` | Optional | Optional |

### Sample Payload

```plaintext
{
  "contact": {
    "firstName": "Admin",
    "lastName": "Yahoo",
    "addressLine1": "Yahoo1",
    "addressLine2": "701st Avenue",
    "city": "Sunnyvale",
    "region": "CA",
    "country": "United States",
    "telephone": "4574888849",
    "email": "admin@yahooinc.com"
  }
}
```

### Billing Contact Object

Billing contact fields are only included in the response for certain seats that need to comply with country-specific laws (i.e. the Sapin II Law in France). The `billingContact` object contains the following fields:

| **Name** | **Description** | **Type** | **Add** | **Update** |
| --- | --- | --- | --- | --- |
| `firstName` | Specifies the first name of the billing contact. | `string` | Required | Required |
| `lastName` | Specifies the last name of the billing contact. | `string` | Required | Required |
| `email` | Specifies the email address of the advertiser billing contact. | `string` | Required | Required |
| `addressLine1` | Specifies the first line of the billing contact information. | `string` | Required | Required |
| `addressLine2` | Specifies the second line of the billing contact information. | `string` | Optional | Optional |
| `addressLine3` | Specifies the third line of the billing contact information. | `string` | Optional | Optional |
| `city` | Specifies the billing contact’s city. | `string` | Required | Required |
| `region` | Specifies the billing contact’s region or state. | `string` | Optional | Optional |
| `postalCode` | Specifies the billing contact’s postal code. | `string` | Optional | Optional |
| `country` | Specifies the billing contact’s country. | `string` | Required | Required |
| `vatNumber` | Specifies the billing contact’s VAT Number. | `string` | Optional | Optional |
| `legalMandateConfirmation` | Confirms sending the legal mandate to the account manager. | `boolean` | Required | Required |

### Sample Payload

```plaintext
{
  "billingContact": {
    "firstName": "Admin",
    "lastName": "Yahoo",
    "email": "admin@yahooinc.com",
    "addressLine1": "Yahoo1",
    "addressLine2": "701st Avenue",
    "city": "Sunnyvale",
    "region": "CA",
    "postalCode": "94089",
    "country": "United States",
    "vatNumber": "123456789",
    "legalMandateConfirmation": true
  }
}
```

### Measurement Rules Object

The Measurement rules object is only included when trying to retrieve all In-Flight Outcomes (IFO) measurement rules under an advertiser. Learn more at [Read Advertiser Measurement Rules](/dsp-api/docs/advertisers#read-advertiser1). The `measurementRules` object is read only and contains the following fields.

| **Name** | **Description** | **Type** | **Add** | **Update** |
| --- | --- | --- | --- | --- |
| `type` | Specifies the type of the measurement rule | `String` | N/A | N/A |
| `ruleId` | Specifies the Rule ID of the measurement rule | `Integer` | N/A | N/A |
| `ruleName` | Specifies the name of the measurement rule | `String` | N/A | N/A |
| `vendorName` | Specifies the name of the vendor of the measurement rule. | `String` | N/A | N/A |
| `lookbackWindow` | Specifies the lookback window for the measurement rule. | `Integer` | N/A | N/A |
| `createdDate` | Specifies the date when the measurement rule was created | `String` | N/A | N/A |

### Sample Response

```json
{
  "type": "IFO",
  "ruleId": 123,
  "ruleName": "ISA Conversion Rule 1",
  "vendorName": "Vendor Name",
  "lookbackWindow": 30,
  "createdDate": "2025-01-15",
}
```

### Measurement Rule Object

The Measurement rule object is only included when trying to retrieve the definition of an IFO measurement rule under an advertiser. Learn more at [Read Advertiser Measurement Rule](/dsp-api/docs/advertisers#read-advertiser-measurement-rule). The `measurementRule` object is read only and contains the following fields.

| **Name** | **Description** | **Type** | **Add** | **Update** |
| --- | --- | --- | --- | --- |
| `type` | Specifies the type of the measurement rule | `String` | N/A | N/A |
| `ruleId` | Specifies the Rule ID of the measurement rule | `Integer` | N/A | N/A |
| `ruleName` | Specifies the name of the measurement rule | `String` | N/A | N/A |
| `vendorName` | Specifies the name of the vendor of the measurement rule. | `String` | N/A | N/A |
| `lookbackWindow` | Specifies the lookback window for the measurement rule. | `Integer` | N/A | N/A |
| `lookbackWindowUnit` | Specifies the unit for the lookback window for the measurement rule. Currently, the only valid value is “DAY”. | `String` | N/A | N/A |
| `createdDate` | Specifies the date when the measurement rule was created. | `String` | N/A | N/A |
| `updatedDate` | Specifies the date when the measurement rule was last updated. | `String` | N/A | N/A |
| `accountId` | Specifies the advertiser ID to which the measurement rule belongs to. | `Integer` | N/A | N/A |
| `description` | Specifies the description of the measurement rule | `String` | N/A | N/A |
| `associatedEntities` | Contains a list of line ids and campaign ids to which the measurement rule is actively associated. lineIds: Contains list of line ids. campaignIds: Contains list of campaign ids. | `Object` | N/A | N/A |
| `upcCodes` | Specifies a list of UPC codes that are assigned during rule creation. Used in the case of IFO measurement rule. | `Object` | N/A | N/A |
| `brands` | Specifies the brands that are assigned to the rule at rule creation. Used in the case of IFO measurement rule. Learn more at [Brands Object](/dsp-api/docs/advertisers#brands-object). | `Object` | N/A | N/A |
| `country` | Specifies the country which the measurement rule is meant to track. Used in the case of Offline measurement rule. | `String` | N/A | N/A |

### Sample Response (IFO)

```json
{
  "type": "IFO",
  "ruleId": 456,
  "ruleName": "ISA Conversion Rule 1",
  "vendorName": "Vendor Name",
  "lookbackWindow": 30,
  "lookbackWindowUnit": DAY, // This is static 
  "trackingCost": “Image: 1.0 | Video: 1.0 | CTV: 0.25”,
  "createdDate": "2025-01-15",
  "updatedDate": "2025-01-15",
  "accountId": 123,
  "description": “Test Rule”,
  "associatedEntityIds": {
    "lineIds": [12345, 67890, 11111],
    "campaignIds": [12345, 67890, 11111]
   }
  "upcCodes": [‘1123’, ‘123’],
  "brands": {
    "advertisers": [],
    "highBrands": [],
    "lowBrands": [
      {
        "advertiserName": "Adv Name ",
        "brandHighName": "Brand High Name ",
        "brandLowName": "Brand Low Name ",
        "category": "",
        "subCategory": ""
      }
    ]
  },
  "pixelId": 10203888,
  "pixelName": "Test"
}
```

### Sample Response (Offline)

```json
{
  "type": "Offline",
  "ruleId": 456,
  "ruleName": "Offline Conversion Rule 1",
  "vendorName": "Yahoo Store Visits",
  "lookbackWindow": 30,
  "lookbackWindowUnit": DAY, // This is static 
  "trackingCost": “Image: 1.0 | Video: 1.0 | CTV: 0.25”,
  "createdDate": "2025-01-15",
  "updatedDate": "2025-01-15",
  "accountId": 123,
  "description": “Test Rule”,
  "associatedEntityIds": {
    "lineIds": [12345, 67890, 11111],
    "campaignIds": [12345, 67890, 11111]
   },
  "country": "US"
}
```

### Brands Object

The Brands object is only included when trying to retrieve the definition of an IFO measurement rule. Learn more at [Measurement Rule Object](/dsp-api/docs/advertisers#measurement-rule-object). The `brands` object contains the following fields.

| **Name** | **Description** | **Type** | **Add** | **Update** |
| --- | --- | --- | --- | --- |
| `advertisers` | Specifies the list of advertiser level brands. Learn more at [Brand Advertiser, High Brand, Low Brand Object](/dsp-api/docs/advertisers#brand-advertiser-high-brand-low-brand-object). | `Object` | N/A | N/A |
| `highBrands` | Specifies the list of high brands. Learn more at [Brand Advertiser, High Brand, Low Brand Object](/dsp-api/docs/advertisers#brand-advertiser-high-brand-low-brand-object). | `Object` | N/A | N/A |
| `lowBrands` | Specifies the list of low brands. Learn more at [Brand Advertiser, High Brand, Low Brand Object](/dsp-api/docs/advertisers#brand-advertiser-high-brand-low-brand-object). | `Object` | N/A | N/A |

### Sample Response

```json
"brands": {
    "advertisers": [],
    "highBrands": [],
    "lowBrands": [
      {
        "advertiserName": "Adv Name ",
        "brandHighName": "Brand High Name ",
        "brandLowName": "Brand Low Name ",
        "category": "",
        "subCategory": ""
      }
    ]
  }
```

### Brand Advertiser, High Brand, Low Brand Object

The Advertiser/High Brand/Low Brand Object is only included when trying to retrieve the definition of an IFO measurement rule. Learn more at [Measurement Rule Object](/dsp-api/docs/advertisers#measurement-rule-object).

| **Name** | **Description** | **Type** | **Add** | **Update** |
| --- | --- | --- | --- | --- |
| `advertiserName` | Specifies the name of the brand advertiser. | `String` | N/A | N/A |
| `brandHighName` | Specifies the name of the high brand. | `String` | N/A | N/A |
| `brandLowName` | Specifies the name of the low brand. | `String` | N/A | N/A |
| `category` | Specifies the category of the brand. | `String` | N/A | N/A |
| `subCategory` | Specifies the subcategory of the brand. | `String` | N/A | N/A |

### Sample Response

```json
"lowBrands": [
      {
        "advertiserName": "Adv Name ",
        "brandHighName": "Brand High Name ",
        "brandLowName": "Brand Low Name ",
        "category": "",
        "subCategory": ""
      }
    ]
```

## Read Advertiser

Get data for a specific advertiser.

### Parameters

| **Parameter** | **Parameter Type** | **Description** | **Data Type** | **Required** |
| --- | --- | --- | --- | --- |
| `id` | path | Specifies the advertiser ID. | `integer` | Y |

### Sample Request URL

```plaintext
GET https://dspapi.admanagerplus.yahoo.com/traffic/advertisers/1
```

### Sample Response

```plaintext
{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1,
    "name": "My Yahoo!!",
    "landingPageUrl": "https://www.yahoo.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": 501,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "mdmId": "41514", 
    "billingPrice": 20,
    "contact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "country": "United States",
      "telephone": "4574888849",
      "email": "admin@yahooinc.com"
    },
    "isCrossdeviceOff": false
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

For seats that need to comply with country-specific laws (such as France’s Sapin II law) the response contains an additional billing contact section.

### Sample Response

```plaintext
{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1,
    "name": "My Yahoo!!",
    "landingPageUrl": "https://www.yahoo.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": 501,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "mdmId": "41524",
    "billingPrice": 20,
    "contact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "country": "United States",
      "telephone": "4574888849",
      "email": "admin@yahooinc.com"
    },
    "billingContact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "email": "admin@yahooinc.com",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "postalCode": "94089",
      "country": "United States",
      "vatNumber": "123456789",
      "legalMandateConfirmation": true
    },
    "isCrossdeviceOff": false
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

## Read Advertisers

Get a filtered list of advertisers.

```plaintext
GET /traffic/advertisers?query={query}&page={page}&limit={limit}&sort={sort}&dir={dir}&startTime={startTime}&endTime={endTime}
```

### Parameters

| **Parameter** | **Parameter Type** | **Description** | **Data Type** | **Required** |
| --- | --- | --- | --- | --- |
| `query` | query | Specifies the search term. Use URL encoding conventions (i.e. a space should be replaced with a `+` or `%20`). | `string` | N |
| `page` | query | Specifies the page number. | `integer` | N |
| `limit` | query | Specifies the total number of items to return. Maximum allowed value is `100`. | `integer` | N |
| `sort` | query | Specifies the column to sort by. | `string` | N |
| `dir` | query | Specifies the sort direction. Allowed values: - `ASC`: data is sorted in ascending order. - `DESC`: data is sorted in descending order. | `string` | N |
| `startTime` | query | Defines the start of the time window. Used with `endTime` to return Advertisers created or updated within a timeframe. | `string` | N |
| `endTime` | query | Defines the end of the time window. Used with `startTime` to return Advertisers created or updated within a timeframe. | `string` | N |

### Sample Request URL

```plaintext
GET https://dspapi.admanagerplus.yahoo.com/traffic/advertisers?page=1&limit=2&startTime=2026-03-01T00:00:00Z&endTime=2026-03-31T00:00:00Z
```

### Sample Response

```plaintext
{
  "response": [
    {
      "status": "ACTIVE",
      "timezone": "America/New_York",
      "currency": "USD",
      "id": 1,
      "name": "My Yahoo!!",
      "landingPageUrl": "http://yahoo.com",
      "iabCategoryId": 1,
      "iabSecondaryCategoryId": 101,
      "accountGroupId": 2491,
      "updatedAt": "2026-03-05T19:10:10Z",
      "createdAt": "2026-03-05T19:10:10Z",
      "mdmId": "41454",
      "isCrossdeviceOff": false
    },
    {
      "status": "ACTIVE",
      "timezone": "America/Los_Angeles",
      "currency": "USD",
      "id": 2,
      "name": "Your Retail Sales Advertiser",
      "landingPageUrl": "http://www.yourretailsalesadvertiser.com",
      "iabCategoryId": 9,
      "iabSecondaryCategoryId": 927,
      "accountGroupId": 2491,
      "updatedAt": "2026-03-05T19:10:10Z",
      "createdAt": "2026-03-05T19:10:10Z",
      "mdmId": "41454",
      "isCrossdeviceOff": false
    }
  ],
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

## Read Advertiser Measurement Rules

Get available Measurement Rules.

```plaintext
GET /traffic/advertisers/{accountId}/measurement-rules
```

### Parameters

| **Parameter** | **Parameter Type** | **Description** | **Data Type** | **Required** |
| --- | --- | --- | --- | --- |
| `accountId` | path | Specifies the advertiser ID. | `integer` | Y |

### Sample Request URL

```plaintext
GET https://dspapi.admanagerplus.yahoo.com/traffic/advertisers/12345/measurement-rules
```

### Response

```json
{
  "response": {
    "measurementRules": [
      {
        "type": "IFO",
        "ruleId": 123,
        "ruleName": "ISA Conversion Rule 1",
        "vendorName": "Vendor Name",
        "lookbackWindow": 30,
        "createdDate": "2025-01-15"
      },
      {
        "type": "Offline",
        "ruleId": 456,
        "ruleName": "Offline Measurement Rule 1",
        "vendorName": "Offline Partner",
        "lookbackWindow": 14,
        "createdDate": "2025-01-10"
      },
      {
        "type": "IFO",
        "ruleId": 789,
        "ruleName": "Mail Purchase Rule 1",
        "vendorName": "Yahoo Mail",
        "lookbackWindow": 7,
        "createdDate": "2025-01-12"
      }
    ],
    "totalCount": 3,
    "warnings": [
      "Unable to fetch Offline rules" // This field shows partial fetch errors 
    ]
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

## Read Advertiser Measurement Rule

Get available Measurement Rules.

```plaintext
GET /traffic/advertisers/{accountId}/measurement-rules/{ruleId}
```

### Parameters

| **Parameter** | **Parameter Type** | **Description** | **Data Type** | **Required** |
| --- | --- | --- | --- | --- |
| `accountId` | path | Specifies the advertiser ID. | `integer` | Y |
| `ruleId` | path | Specifies the measurement rule ID. | `Integer` | Y |

### Sample Request URL

```plaintext
GET https://dspapi.admanagerplus.yahoo.com/traffic/advertisers/12345/measurement-rules/890
```

### Sample Response (IFO)

```json
{
  "response": {
    "type": "IFO",
    "ruleId": 456,
    "ruleName": "ISA Conversion Rule 1",
    "vendorName": "Vendor Name",
    "lookbackWindow": 30,
    "lookbackWindowUnit": "DAY",
    "trackingCost": "Image: 1.0 | Video: 1.0 | CTV: 0.25",
    "createdDate": "2025-01-15",
    "updatedDate": "2025-01-15",
    "accountId": 123,
    "description": "Test Rule",
    "associatedEntityIds": {
      "lineIds": [
        12345,
        67890,
        11111
      ],
      "campaignIds": [
        12345,
        67890,
        11111
      ]
    },
    "upcCodes": [
      "1123",
      "123"
    ],
    "brands": {
      "advertisers": [],
      "highBrands": [],
      "lowBrands": [
        {
          "advertiserName": "Adv Name ",
          "brandHighName": "Brand High Name ",
          "brandLowName": "Brand Low Name ",
          "category": "",
          "subCategory": ""
        }
      ]
    },
    "pixelId": 10203888,
    "pixelName": "Test"
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

### Response (Offline)

```json
{
  "response": {
    "type": "Offline",
    "ruleId": 456,
    "ruleName": "Offline Conversion Rule 1",
    "vendorName": "Yahoo Store Visits",
    "lookbackWindow": 30,
    "lookbackWindowUnit": "DAY",
    "trackingCost": "Image: 1.0 | Video: 1.0 | CTV: 0.25",
    "createdDate": "2025-01-15",
    "updatedDate": "2025-01-15",
    "accountId": 123,
    "description": "Test Rule",
    "associatedEntityIds": {
      "lineIds": [
        12345,
        67890,
        11111
      ],
      "campaignIds": [
        12345,
        67890,
        11111
      ]
    },
    "country": "US"
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

## Export Product Catalog

An email containing an excel sheet with product catalog details of a measurement rule is sent to the current user.

```plaintext
GET traffic/v3/advertisers/{advertiserId}/rules/{ruleId}/products
```

### Parameters

| **Parameter** | **Parameter Type** | **Description** | **Data Type** | **Required** |
| --- | --- | --- | --- | --- |
| `advertisertId` | path | Specifies the advertiser ID. | `integer` | Y |
| `ruleId` | path | Specifies the measurement rule ID | `Integer` | Y |

### Sample Request URL

```plaintext
GET https://dspapi.admanagerplus.yahoo.com/traffic/v3/advertisers/123/rules/456/products
```

### Response

```json
{
  "response": {
    "message": "Report created, will be emailed shortly"
   },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

## Create Advertiser

Create a new advertiser.

```plaintext
POST /traffic/advertisers
```

### Parameters

All fields are specified in the body of the `application/json` payload.

### Sample Request URL

```plaintext
POST https://dspapi.admanagerplus.yahoo.com/traffic/advertisers
```

### Sample Request Body

```plaintext
{
  "name": "TEST_1_3",
  "landingPageUrl": "http://www.example.com",
  "iabCategoryId": 5,
  "timezone": "Etc/GMT",
  "currency": "USD",
  "status": "ACTIVE",
  "billingPrice": 40.5,
  "contact": {
    "addressLine1": "1 N.First St",
    "addressLine2": "",
    "city": "Sunnyvale",
    "region": "CA",
    "postalCode": "94056",
    "country": "United States"
  }
}
```

### Sample Response

```plaintext
{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1259301,
    "name": "TEST_1_3",
    "landingPageUrl": "http://www.example.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": -1,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "billingPrice": 40.5,
    "contact": {
      "addressLine1": "1 N.First St",
      "addressLine2": "",
      "city": "Sunnyvale",
      "region": "CA",
      "postalCode": "94056",
      "country": "United States"
    },
    "isCrossdeviceOff": false
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

For seats that need to comply with country-specific laws (such as France’s Sapin II law) the payload should contain the billing contact fields.

### Sample Request Body

```plaintext
{
  "name": "TEST_1_3",
  "landingPageUrl": "http://www.example.com",
  "iabCategoryId": 5,
  "timezone": "Etc/GMT",
  "currency": "USD",
  "status": "ACTIVE",
  "billingPrice": 40.5,
  "contact": {
    "addressLine1": "1 N.First St",
    "addressLine2": "",
    "city": "Sunnyvale",
    "region": "CA",
    "postalCode": "94056",
    "country": "United States"
  },
  "billingContact": {
    "firstName": "Admin",
    "lastName": "Yahoo",
    "email": "admin@yahooinc.com",
    "addressLine1": "Yahoo1",
    "addressLine2": "701st Avenue",
    "city": "Sunnyvale",
    "region": "CA",
    "postalCode": "94089",
    "country": "United States",
    "vatNumber": "123456789",
    "legalMandateConfirmation": true
   }
}
```

### Sample Response

```plaintext
{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1259301,
    "name": "TEST_1_3",
    "landingPageUrl": "http://www.example.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": -1,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "billingPrice": 40.5,
    "contact": {
      "addressLine1": "1 N.First St",
      "addressLine2": "",
      "city": "Sunnyvale",
      "region": "CA",
      "postalCode": "94056",
      "country": "United States"
    },
    "billingContact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "email": "admin@yahooinc.com",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "postalCode": "94089",
      "country": "United States",
      "vatNumber": "123456789",
      "legalMandateConfirmation": true
    },
    "isCrossdeviceOff": false
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

## Update Advertiser

Update an existing advertiser.

```plaintext
PUT /traffic/advertisers/{id}
```

Partial updates are supported; values of supported fields that are not in the payload remain unchanged. For seats that need to comply with country-specific laws (such as France’s Sapin II law) the payload can contain the billing contact fields.

### Parameters

The Advertiser `id` is specified in the url path. All other fields are specified in the body of the `application/json` payload.

### Sample Request URL

```plaintext
PUT https://dspapi.admanagerplus.yahoo.com/traffic/advertisers/1
```

### Sample Request Body

```plaintext
{
  "status": "ACTIVE",
  "isCrossdeviceOff": true,
  "billingPrice": 23,
  "currency": "USD"
}
```

### Sample Response

```plaintext
{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1,
    "name": "My Yahoo!!",
    "landingPageUrl": "https://www.yahoo.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": 501,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "mdmId": "41454",
    "billingPrice": 23,
    "contact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "country": "United States",
      "telephone": "4574888849",
      "email": "admin@yahooinc.com",
      "postalCode": "94056"
    },
    "isCrossdeviceOff": true
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```

## Delete Advertiser

The DSP Traffic API does not support deletion of advertisers.

## Read Advertiser Beacon Lookups

Get available beacons.

```plaintext
GET /traffic/advertisers/{accountId}/beaconlookups
```

### Parameters

| **Parameter** | **Parameter Type** | **Description** | **Data Type** | **Required** |
| --- | --- | --- | --- | --- |
| `accountId` | path | Specifies the advertiser ID. | `integer` | Y |

### Sample Request URL

```plaintext
GET https://dspapi.admanagerplus.yahoo.com/traffic/advertisers/1356341/beaconlookups
```

### Sample Response

```plaintext
{
  "response": [
    {
      "id": 6508313,
      "name": "test conversion1",
      "dotPixel": true
    },
    {
      "id": 6508309,
      "name": "CPA Pixel",
      "dotPixel": true
    }
  ],
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}
```