---
title: CampaignCreate
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/campaigncreate
---

# CampaignCreate

The request body for creating a new campaign.

## Declaration

```data
object CampaignCreate
```

## Properties

name: The advertiser-given name of this campaign. Maximum 200 characters. Must be non-empty. Mutable. startTime: The scheduled start date and time of this campaign. Format: yyyy-MM-dd'T'HH:mm:ss.SSS in UTC (for example, 2025-09-01T00:00:00.000). If omitted, the campaign starts immediately upon activation. Mutable. endTime: The scheduled end date and time. Format: yyyy-MM-dd'T'HH:mm:ss.SSS in UTC (for example, 2025-12-31T23:59:59.000). Omit to keep the campaign running indefinitely. Mutable. dailyBudget: The daily spend cap for this campaign. See DailyBudgetCreate. Mutable. sharedBudgets: One or more budget order assignments for this campaign. Can be provided alongside dailyBudget. See SharedBudgetAssignmentCreate. targeting: Country or region, supply source, and placement targeting for this campaign. See CampaignTargetingCreate. Mutable. bidStrategy: Bid strategy governing how this campaign competes in auctions. bidStrategyType and bidStrategyGoal must both be supplied and must match one of the pairings in BidStrategy. Omitting either field, or pairing a mismatched goal, returns an error. See BidStrategyCreate. Mutable. invoiceDetail: Invoice and billing contact details. Required for Line of Credit accounts. See InvoiceDetailCreate. regulationResponses: Regulatory consent acknowledgments required in certain markets. See RegulationResponseCreate. adAccountId: The ad account this campaign belongs to. Immutable after creation. billingEvent: The billing event for this campaign. See BillingEvent. Immutable after creation. promotedObjectId: The identifier for the promoted object (for example, an app Adam ID). Immutable after creation. promotedObjectType: The type of the promoted object. See PromotedObjectType. Immutable after creation. status: Advertiser-configurable serving status, ENABLED or PAUSED. Specify it explicitly if a specific initial status is required. See CampaignStatus.

## Discussion

Discussion Creating a campaign ties together what’s being promoted, a budget, targeting, and a bid strategy in a single request. Example {   "name": "AwayFinder App Campaign",   "startTime": "2025-09-01T00:00:00.000",   "endTime": "2025-12-31T23:59:59.000",   "dailyBudget": {     "value": {       "amount": "100.00",       "currency": "USD"     }   },   "sharedBudgets": [     {       "budgetId": 555666777     }   ],   "targeting": {     "countryOrRegion": {       "include": [         "US"       ]     },     "supplyPlacement": {       "include": [         "APPSTORE_SEARCH_RESULTS"       ]     }   },   "bidStrategy": {     "bidStrategyType": "MANUAL_CPT",     "bidStrategyGoal": "TAP"   },   "invoiceDetail": {     "name": "AwayFinder Inc.",     "orderNumber": "PO-100234",     "clientName": "AwayFinder Inc.",     "primaryBuyerName": "Jordan Lee",     "primaryBuyerEmail": "jordan.lee@awayfinder.com",     "billingEmail": "billing@awayfinder.com"   },   "regulationResponses": [     {       "regulationType": "CAMPAIGN_SAPIN_LAW",       "responseValue": "NOT_AGENT"     }   ],   "adAccountId": 123456789,   "billingEvent": "TAPS",   "promotedObjectId": "987654321",   "promotedObjectType": "APPSTORE_APP",   "status": "ENABLED" }

## Topics

### Dictionaries

- [CampaignCreate.BidStrategy](apple-ads-platform-api/campaigncreate/bidstrategy-data.dictionary.md)
- [CampaignCreate.DailyBudget](apple-ads-platform-api/campaigncreate/dailybudget-data.dictionary.md)
- [CampaignCreate.InvoiceDetail](apple-ads-platform-api/campaigncreate/invoicedetail-data.dictionary.md)
- [CampaignCreate.Targeting](apple-ads-platform-api/campaigncreate/targeting-data.dictionary.md)

### Type Aliases

- [CampaignCreate.BillingEvent](apple-ads-platform-api/campaigncreate/billingevent-data.typealias.md)
- [CampaignCreate.PromotedObjectType](apple-ads-platform-api/campaigncreate/promotedobjecttype-data.typealias.md)
- [CampaignCreate.Status](apple-ads-platform-api/campaigncreate/status-data.typealias.md)

## See Also

- [Campaign](apple-ads-platform-api/campaign.md)
- [CampaignUpdate](apple-ads-platform-api/campaignupdate.md)
- [CampaignResponse](apple-ads-platform-api/campaignresponse.md)
- [CampaignQueryResponse](apple-ads-platform-api/campaignqueryresponse.md)
- [CampaignTargeting](apple-ads-platform-api/campaigntargeting.md)
- [CampaignTargetingCreate](apple-ads-platform-api/campaigntargetingcreate.md)
- [DailyBudget](apple-ads-platform-api/dailybudget.md)
- [DailyBudgetCreate](apple-ads-platform-api/dailybudgetcreate.md)
- [Money](apple-ads-platform-api/money.md)
- [InvoiceDetailCreate](apple-ads-platform-api/invoicedetailcreate.md)
- [LegacyAppLimitedStatusReasonDetailsResponse](apple-ads-platform-api/legacyapplimitedstatusreasondetailsresponse.md)
- [CampaignTargetingUpdate](apple-ads-platform-api/campaigntargetingupdate.md)
- [DailyBudgetUpdate](apple-ads-platform-api/dailybudgetupdate.md)
- [LegacyAppLimitedStatusReasonDetails](apple-ads-platform-api/legacyapplimitedstatusreasondetails.md)
- [ResponsePagination](apple-ads-platform-api/responsepagination.md)