Skip to main content
PATCH
Update ad

Overview

Update an existing ad. Omitted fields stay unchanged. campaign_id and office_id cannot be changed after creation. Targeter uses this for budget changes, flight date shifts, creative swaps, targeting edits, and platform mix updates. Return 409 if the ad is completed, rejected, or otherwise not editable.

Request

Headers

  • Authorization: Bearer {token} (required)
  • Content-Type: application/json

Path Parameters

string
required
Publisher-generated ad id returned from Create ad

Body Parameters

All fields are optional. Send only the fields that should change. Shapes match Create ad.
string
Ad name / title
number
Updated spend cap
object
Updated geographic targeting
string
When the ad may start delivering (inclusive). UTC ISO 8601 date-time.
string
When the ad must stop delivering (inclusive). UTC ISO 8601 date-time.
object
Updated objective and optimization event
string[]
Replacement list of platform ids (not a patch merge)
object
Replacement landing page and creatives. Include target_url plus at least one of images, videos, or html5.

Example Request

Response

Success (200)

Returns the full ad after the update, including ad_id and current status.

Error Responses

400 - Invalid request payload

401 - Unauthorized

404 - Ad not found

409 - Ad cannot be updated

500 - Server Error

Authorizations

Authorization
string
header
required

API token issued to Targeter during integration setup. Send as Authorization: Bearer <token>.

Path Parameters

ad_id
string
required

Publisher-generated ad id returned from POST /ads

Body

application/json

Any subset of mutable ad fields. Omitted fields are unchanged.

name
string
Example:

"Majorstuenveien 14 — oppdatert"

budget
number

Spend cap for the ad

Example:

5000

target_location
object
start_date
string<date-time>
end_date
string<date-time>
goal_config
object
publisher_platforms
string[]
Minimum array length: 1
material
object

Response

Ad updated

ad_id
string
required

Publisher-generated ad id

Example:

"ad_9pL2wR"

campaign_id
string
required

Targeter campaign id this ad belongs to

Example:

"AbC123xyz"

office_id
string
required

Publisher office id from POST /offices or GET /offices

Example:

"off_8k2mQx"

name
string
required

Ad name / title

Example:

"Majorstuenveien 14"

status
enum<string>
required

Delivery status of the ad

Available options:
draft,
pending_review,
scheduled,
active,
paused,
completed,
rejected,
error
Example:

"active"

budget
number
required

Spend cap for the ad

Example:

5000

target_location
object
required
start_date
string<date-time>
required

When the ad may start delivering (inclusive)

Example:

"2026-08-20T00:00:00Z"

end_date
string<date-time>
required

When the ad must stop delivering (inclusive)

Example:

"2026-09-03T23:59:59Z"

goal_config
object
required
publisher_platforms
string[]
required

Platform ids from GET /publisher-platforms

Example:
material
object
required
created_at
string<date-time>
Example:

"2026-08-19T08:12:00Z"

updated_at
string<date-time>
Example:

"2026-08-19T08:12:00Z"