---
title: "POST /v1/bidders/{biddersId}/creatives:watch"
method: POST
path: "/v1/bidders/{biddersId}/creatives:watch"
tags: ["bidders"]
---

# POST /v1/bidders/{biddersId}/creatives:watch

`POST /v1/bidders/{biddersId}/creatives:watch`

## Request

- Base URL: `https://realtimebidding.googleapis.com`
- URL: `https://realtimebidding.googleapis.com/v1/bidders/{biddersId}/creatives:watch`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/realtime-bidding`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/realtime-bidding`
- TypeScript: <https://skmtc.dev/google/apis/realtimebidding/docs/v1/bidders/:biddersId/creatives:watch/post.ts> (a function with typed inputs; its response is checked against the schema)

Watches all creatives pertaining to a bidder. It is sufficient to invoke this endpoint once per bidder. A Pub/Sub topic will be created and notifications will be pushed to the topic when any of the bidder's creatives change status. All of the bidder's service accounts will have access to read from the topic. Subsequent invocations of this method will return the existing Pub/Sub configuration.

## Path parameters

- `biddersId` string, required

## Request body

- WatchCreativesRequest: A request to receive push notifications when any of the creatives belonging to the bidder changes status.

## Response `200`

Successful response

- WatchCreativesResponse: A response for the request to receive push notification when a bidder's creatives change status.
  - `subscription` string: The Pub/Sub subscription that can be used to pull creative status notifications. This would be of the format `projects/{project_id}/subscriptions/{subscription_id}`. Subscription is created with pull delivery. All service accounts belonging to the bidder will have read access to this subscription. Subscriptions that are inactive for more than 90 days will be disabled. Use watchCreatives to re-enable the subscription.
  - `topic` string: The Pub/Sub topic that will be used to publish creative serving status notifications. This would be of the format `projects/{project_id}/topics/{topic_id}`.

---

[API](https://skmtc.dev/google/apis/realtimebidding.md) - [All operations](https://skmtc.dev/google/apis/realtimebidding/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/realtimebidding/revisions/a3d0cf023b56?raw)