Contents

Create an Ad Creative

Add a new ad creative that defines the visual presentation and tap destination for an ad.

URL

POST https://api.ads.apple.com/v1/creatives

Header Parameters

NameTypeDescription
X-Ap-Context Requiredstring

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
CreativeResponse
400Bad Request
Content-Type: application/json
ErrorResponse
401Unauthorized
Content-Type: application/json
ErrorResponse
403Forbidden
Content-Type: application/json
ErrorResponse
404Not Found
Content-Type: application/json
ErrorResponse
429Too Many Requests
Content-Type: application/json
ErrorResponse
500Internal Server Error
Content-Type: application/json
ErrorResponse

Discussion

This endpoint creates an ad creative that defines the visual presentation of an ad. It contains the content, branding, and destination for a specific ad creative type. Ad creatives are independent of campaigns and ad groups. One ad creative can be linked to multiple ads across different campaigns.

  • The three required fields are name, creativeType, and destination.

  • The creativeSpec structure varies by type and carries the type-specific content payload.

  • The destination field defines where a tap on the ad leads. For App Ads ad creatives (DEFAULT_PRODUCT_PAGE, CUSTOM_PRODUCT_PAGE), set the app identifier and optional product page identifier inside destination.parameters, not at the root of the request body.

  • After creation, systemStatus reflects the review state.

  • The response returns the ad creative identifier in the result.id field. This value is what you supply as creativeId in the body of a Create an Ad request.

Payload Examples

See Also