Skip to content
Ads API •References / Ad Sets / Create Ad Set

Create Ad Set

Creates a new ad set.

Request

  • ad_account_id
    string [uuid]
    Required
  • campaign_id
    string [uuid]
    Required
  • budget_micro_amount
    integer [int64]
    Required

    Total budget for the ad set multiplied by x10 to the 6th power.

    Example value: 5000000
  • end_date
    string [date-time]
    Required

    Date the ad set will end on. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example value: "2022-12-06T14:00:00Z"
  • name
    string
    Required

    Name given to identify the ad set.

    Example value: "New ad set"
  • start_date
    string [date-time]
    Required

    Date the ad set will start on. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example value: "2022-11-06T14:00:00Z"
  • Required
  • ad_ids
    array of strings

    The Unique ID returned back when a new ad is created.

  • Can utilise the 3 parameters to set a Frequency cap by Day, Week and Month.

  • bid_optimization_goal
    string [bid-optimization-goal]
    Required
    Example value: "AD_COMPLETES"Allowed values: "UNSET", "EVEN_IMPRESSION_DELIVERY", "REACH", "AD_COMPLETES"
  • bid_strategy
    string [bid-strategy]
    Required
    Example value: "MAX_BID"Allowed values: "UNSET", "MAX_BID"
  • bid_micro_amount
    integer [int64]
    Required
    Example value: 12000000

Response

  • ad_set_id
    string [uuid]

Response sample

{  "ad_set_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91"}