Create a Campaign
Create a new advertising campaign with a promoted object, budget, targeting, and bid strategy configuration.
URL
POST https://api.ads.apple.com/v1/campaignsHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | CampaignResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 404 | Not Found Content-Type: application/json | ErrorResponse | |
| 429 | Too Many Requests Content-Type: application/json | ErrorResponse | |
| 500 | Internal Server Error Content-Type: application/json | ErrorResponse |
Discussion
This endpoint creates a new campaign with a promoted object, budget, targeting, and bid strategy configuration. Every campaign identifies what it promotes through two immutable fields set at creation, promotedObjectType and promotedObjectId. You can’t change these fields after you create the campaign. To advertise a different app or brand, create a new campaign. For a full comparison of App Store and Apple Maps campaigns, including supported placements, supply sources, and creative sources, see the Campaigns Endpoints overview.
The promotedObjectType field determines which kind of object promotedObjectId points to:
APPSTORE_APP: The campaign promotes an iOS app.
promotedObjectIdis the app’sadamId, retrieved from Search for Apps. See Campaigns Endpoints for eligibility requirements before creating the campaign.BUSINESS_BRAND: The campaign promotes a brand and its business locations on Apple Maps.
promotedObjectIdis the brand’s unique identifier, retrieved from Query Brands orGET /v1/advertiser-resources?resourceType=BUSINESS_BRAND. See Campaigns Endpoints for eligibility requirements before creating the campaign.
Campaign Type | Required Fields |
|
|
|---|---|---|---|
App Store |
|
| The app’s |
Apple Maps |
|
| The brand’s unique identifier. Retrieve it from Query Brands or |
Within bidStrategy, bidStrategyType and bidStrategyGoal are both required and must correspond per the pairings in BidStrategy (for example, MAX_CONVERSIONS → INSTALL, MANUAL_CPT → TAP). Omitting either field, or sending a goal that doesn’t match the type, returns an error.