Skip to main content
POST
Pause ad

Overview

Stop delivery for an active or scheduled ad. The ad stays in your system so Targeter can still fetch insights and later resume it. Do not change budget, dates, or creatives. Only status should become paused.

Request

Headers

  • Authorization: Bearer {token} (required)

Path Parameters

string
required
Publisher-generated ad id returned from Create ad

Example Request

Response

Success (200)

string
Publisher-generated ad id
string
Always paused on success
string
UTC timestamp of the status change

Error Responses

401 - Unauthorized

404 - Ad not found

409 - Ad cannot be paused

Pausing an ad that is already paused should return 200 with status: "paused" (idempotent), not 409.

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

Response

Ad paused

ad_id
string
required
Example:

"ad_9pL2wR"

status
enum<string>
required

Delivery status of the ad

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

"active"

updated_at
string<date-time>
Example:

"2026-08-19T09:00:00Z"