---
title: Create a Campaign
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/post-campaigns
---

# 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/campaigns

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

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. promotedObjectId is the app’s adamId, 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. promotedObjectId is the brand’s unique identifier, retrieved from Query Brands or GET /v1/advertiser-resources?resourceType=BUSINESS_BRAND. See Campaigns Endpoints for eligibility requirements before creating the campaign.  |  |  |   |  |  |   |  |  |  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. Payload Examples

## See Also

- [Query Campaigns](apple-ads-platform-api/post-campaigns-query.md)
- [Get a Campaign](apple-ads-platform-api/get-campaigns-_id_.md)
- [Update a Campaign](apple-ads-platform-api/put-campaigns-_id_.md)
- [Delete a Campaign](apple-ads-platform-api/delete-campaigns-_id_.md)
- [Get Legacy App Limited Status Reason Details](apple-ads-platform-api/get-campaigns-_id_-legacy-app-limited-status-reason-details.md)