Skip to content
/
Create an Advertiser

Create an Advertiser

Request

Create an advertiser

Security
Auth0(Required scopes: offline_accessmanage:services)
Bodyapplication/jsonrequired
ad_server_idinteger, (int32)required
Example:126
data_sharing_enabledboolean
dmp_enabledstring
Enum:"disabled""inherits"
domainstring, <= 255 charactersrequired
external_idstring or null, <= 255 characters
frequency_intervalstring or null
Default:"not-applicable"
Enum:"hour""day""week""month""not-applicable"
frequency_typestring or null
Default:"no-limit"
Enum:"no-limit""asap""even"
frequency_amountinteger or null, (int32)
Example:3
minimize_multi_adsboolean
namestring, [ 1 .. 64 ] charactersrequired
statusboolean
vertical_idinteger, (int32)required
Example:433
ads_txt_verifiedstring or null
Enum:"ANY""AUTHORIZED_ONLY""AUTHORIZED_DIRECT_ONLY""NONE"
politicalboolean
connected_id_typestring
Value:"DETERMINISTIC_FIRST"
mfa_avoidancestring
Enum:"INHERIT""ALLOW_ALL""EXCLUDE_MFA"
attribution_levelstring
Default:"INDIVIDUAL"
Enum:"INDIVIDUAL""HOUSEHOLD"
targeting_identity_levelstring
Default:"INDIVIDUAL"
Enum:"INDIVIDUAL""HOUSEHOLD"
advertiser_brainboolean
Default:true
vendor_attributionsArray of objects or null
agency_idinteger, (int32), >= 1required
Example:125
curl -i -X POST \
  https://api.mediamath.com/api/v3.0/advertisers \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "ad_server_id": 126,
    "data_sharing_enabled": true,
    "dmp_enabled": "disabled",
    "domain": "string",
    "external_id": "string",
    "frequency_interval": "hour",
    "frequency_type": "no-limit",
    "frequency_amount": 3,
    "minimize_multi_ads": true,
    "name": "string",
    "status": true,
    "vertical_id": 433,
    "ads_txt_verified": "ANY",
    "political": true,
    "connected_id_type": "DETERMINISTIC_FIRST",
    "mfa_avoidance": "INHERIT",
    "attribution_level": "INDIVIDUAL",
    "targeting_identity_level": "INDIVIDUAL",
    "advertiser_brain": true,
    "vendor_attributions": [
      {
        "vendor_id": 18,
        "impression_pixel": "string"
      }
    ],
    "agency_id": 125
  }'

Responses

Advertiser created response

Bodyapplication/json
dataobject(advertiser)
metaobject(single_metadata)
Response
{
  "data": {
    "ad_server_id": 126,
    "data_sharing_enabled": true,
    "dmp_enabled": "disabled",
    "domain": "string",
    "external_id": "string",
    "frequency_interval": "hour",
    "frequency_type": "no-limit",
    "frequency_amount": 3,
    "minimize_multi_ads": true,
    "name": "string",
    "status": true,
    "vertical_id": 433,
    "ads_txt_verified": "ANY",
    "political": true,
    "connected_id_type": "DETERMINISTIC_FIRST",
    "mfa_avoidance": "INHERIT",
    "attribution_level": "INDIVIDUAL",
    "targeting_identity_level": "INDIVIDUAL",
    "advertiser_brain": true,
    "vendor_attributions": [ … ],
    "id": 0,
    "ad_server_fee": 0,
    "agency_id": 0,
    "created_on": "2019-08-24T14:15:22Z",
    "entity_type": "string",
    "updated_on": "2019-08-24T14:15:22Z",
    "version": 0,
    "effective_ads_txt_verified": "string",
    "allow_x_strat_optimization": true,
    "billing_contact_id": 1,
    "sales_contact_id": 1,
    "agency": { … },
    "inherited_mfa_avoidance": "INHERIT",
    "inherited_mfa_from": "Organization"
  },
  "meta": {
    "status": "success"
  }
}