---
title: "Updates an ad based on the inputs passed in"
method: PUT
path: "/api/v3/advertisers/{advertiserId}/ads/{adId}"
tags: ["Ad"]
---

# Updates an ad based on the inputs passed in

`PUT /api/v3/advertisers/{advertiserId}/ads/{adId}`

## Request

- Base URL: `https://ads.nextdoor.com`
- URL: `https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/ads/{adId}`
- Auth: HTTP bearer

## Path parameters

- `adId` string, required
- `advertiserId` string, required

## Request body

- object
  - `creative_id` string, nullable: The creative id for this ad
  - `name` string, nullable: The ad name

## Response `200`

The updated ad

- object
  - `adgroup_id` string: The ad group id to associated with this ad
  - `advertiser_id` string: The advertiser id who owns the ad
  - `created_at` string, date-time: The UTC time when this ad was created
  - `creative_id` string: The creative id associated with this ad
  - `id` string: The id of the ad
  - `name` string: The name of the ad
  - `status` 'ACTIVE' | 'INACTIVE' | 'PENDING' | 'INELIGIBLE' | 'ARCHIVED': The delivery status of this ad
  - `updated_at` string, date-time: The UTC time when this ad was last updated
  - `user_status` 'ACTIVE' | 'INACTIVE' | 'ARCHIVED': The status of this ad set by the user

## Other responses

- `400`: Bad Request. Indicates that the server cannot process the request due to client-side error. For example invalid input.
- `401`: Unauthorized. The API key is invalid and needs to be re-generated.
- `403`: Forbidden. The token passed in has been successfully authenticated, but can’t perform the given action due to not having sufficient permissions.
- `500`: Internal server error.
- `503`: The server is temporarily unable to handle the request due to maintenance or overload.

---

[API](https://skmtc.dev/nextdoor/apis/advertising.md) - [All operations](https://skmtc.dev/nextdoor/apis/advertising/llms.txt) - [OpenAPI document](https://skmtc.dev/nextdoor/apis/advertising/revisions/cdbbecabcffc?raw)