---
title: Update an Ad
framework: Apple Ads
role: symbol
role_heading: Web Service Endpoint
platforms: [search ads 5.0+]
path: apple_ads/update-an-ad
---

# Update an Ad

Updates an ad in an ad group.

## URL

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

## Path Parameters

adId: A unique identifier representing the assignment relationship between an ad group and an Ad. adgroupId: The unique identifier for the ad group. campaignId: The unique identifier for the campaign.

## Response Codes

200 OK: If the call succeeds, the API returns the AdResponse object in the response payload with an HTTP status code of 200(OK). If unsuccessful, the HTTP status code indicates the error with details in the error message. 400 Bad Request: An invalid query or missing required parameters. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 404 Not Found: The API can’t locate the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later.

## Mentioned in

Apple Ads Campaign Management API 4

## Discussion

Discussion Use this endpoint to update or replace an Ad. Use your adId in the resource path. The follow-up step is to create an Ad using your creativeId. See 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. Payload example: Update an ad

## HTTP Body

The request body that includes the details of the Creative.

## See Also

### Ad Endpoints

- [Create an Ad](apple_ads/create-an-ad.md)
- [Find Ads](apple_ads/find-ads.md)
- [Find Ads (org-level)](apple_ads/find-ads-(org-level).md)
- [Get an Ad](apple_ads/get-an-ad.md)
- [Get All Ads](apple_ads/get-all-ads.md)
- [Delete an Ad](apple_ads/delete-an-ad.md)