<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Create-an-Ad",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "rest:apple_ads:post:v5-campaigns-{}-adgroups-{}-ads"
  },
  "title" : "Create an Ad"
}
-->

# Create an Ad

Creates an ad in an ad group with a creative.

## Discussion

Use this endpoint to create an [`Ad`](/documentation/apple_ads/Ad) object using your `creativeId` in the request payload. To obtain a `creativeId`, use the [`Create a Creative`](/documentation/apple_ads/Create-a-Creative) endpoint. See [`Update an Ad`](/documentation/apple_ads/Update-an-Ad) to update or replace the ad group assignment of an [`Ad`](/documentation/apple_ads/Ad) object.

In API version 5.2, this endpoint supports default product page ads. For more information, see [Apple Ads Campaign Management API 5](/documentation/Apple_Ads/apple-search-ads-campaign-management-api-5).

The `Id` in the response is your `adId`, representing the assignment of a creative to an [`AdGroup`](/documentation/apple_ads/AdGroup). Use your `adId` in the resource path with [`Get an Ad`](/documentation/apple_ads/Get-an-Ad), [`Update an Ad`](/documentation/apple_ads/Update-an-Ad), [`Delete an Ad`](/documentation/apple_ads/Delete-an-Ad), and in [`Get Ad-Level Reports`](/documentation/apple_ads/Get-Ad-Level-Reports). Your `adId` is also output in the <doc://com.apple.documentation/documentation/AdServices> attribution framework.

### Payload example: Create an ad

**Request:**

```
POST https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups/{adgroupId}/ads

{
  "creativeId": 94895512,
  "name": "Trip Trek custom product page variation",
  "status": "ENABLED"
}
```

**Response:**

```json
{
  "id": 573408745,
  "orgId": 39872140,
  "campaignId": 570798765,
  "adGroupId": 427916203,
  "creativeId": 94895512,
  "name": "Trip Trek custom product page variation",
  "creativeType": "CUSTOM_PRODUCT_PAGE",
  "status": "ENABLED",
  "servingStatus": "RUNNING",
  "statusReasons": [],
  "deleted": false,
  "creationTime": "2024-10-09 21:25:33",
  "modificationTime": "2024-10-09 21:25:33"
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)