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

# Update an Ad

Updates an ad in an ad group.

## Discussion

Use this endpoint to update or replace an [`Ad`](/documentation/apple_ads/Ad). Use your `adId` in the resource path. The follow-up step is to create an [`Ad`](/documentation/apple_ads/Ad) using your `creativeId`. See [`Create an Ad`](/documentation/apple_ads/Create-an-Ad). You can assign one active custom product page to an ad group. For information about how to edit a subset of object properties without having to include all object properties in the payload, see the Use Partial Updates section in [Using Apple Ads API Functionality](/documentation/Apple_Ads/using-apple-search-ads-api-functionality).

### Payload example: Update an ad

**Request:**

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

{
  "name": "Trip Trek custom product page variation",
  "status": "PAUSED"
}
```

**Response:**

```json
{
  "id": 573408745,
  "orgId": 39872140,
  "campaignId": 570798765,
  "adGroupId": 427916203,
  "creativeId": 94895512,
  "name": "Trip Trek custom product page variation",
  "creativeType": "CUSTOM_PRODUCT_PAGE",
  "status": "PAUSED",
  "servingStatus": "NOT_RUNNING",
  "servingStateReasons": [
    "PAUSED_BY_USER"
  ],
  "deleted": false,
  "creationTime": "2024-11-16T01:15:32.412Z",
  "modificationTime": "2024-11-16T01:15:32.412Z"
}
```

---

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)