Ads API •References / Ad Sets / Create Ad Set
Create Ad Set
Creates a new ad set.
Request
- ad_account_idstring [uuid]Required
- campaign_idstring [uuid]Required
- budget_micro_amountinteger [int64]Required
Total budget for the ad set multiplied by x10 to the 6th power.
Example value:5000000
- end_datestring [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"
- namestringRequired
Name given to identify the ad set.
Example value:"New ad set"
- start_datestring [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_idsarray 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_goalstring [bid-optimization-goal]RequiredExample value:
"AD_COMPLETES"
Allowed values:"UNSET"
,"AD_COMPLETES"
,"CLICKS"
,"EVEN_IMPRESSION_DELIVERY"
,"REACH"
- bid_strategystring [bid-strategy]RequiredExample value:
"MAX_BID"
Allowed values:"UNSET"
,"MAX_BID"
- bid_micro_amountinteger [int64]RequiredExample value:
12000000
Response
- ad_set_idstring [uuid]
Response sample
{ "ad_set_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91"}