Place a sealed bid for an owned, approved creative within the grant's mandate.

Place a sealed bid for an owned, approved creative within the grant's mandate.

post/v1/agent/bids

Request

  • Base URL: https://api.nowyourlink.com
  • URL: https://api.nowyourlink.com/v1/agent/bids
  • Auth: OAuth 2 (authorization code, authorization URL https://api.nowyourlink.com/oauth/authorize, token URL https://api.nowyourlink.com/oauth/token, scopes: bids:write)

Headers

Idempotency-Keystring required

Client-chosen unique key, 1-255 visible ASCII characters. The same key returns the same result.

Request body

daystring date required

Settled auction date in UTC, YYYY-MM-DD.

ad_idstring required

Owned, approved creative id.

amount_centsinteger required

Any cent amount in range. The mandate's max_bid_cents caps it further.

currency'EUR' required
payment_method_idstring

Optional owned saved card for a new bid. Bid increases use the account default card.

Response

Bid accepted (or replayed for a repeated Idempotency-Key). The body is the auction state.

daystring date required

Settled auction date in UTC, YYYY-MM-DD.

phase'IDLE' | 'OPEN' | 'CLOSED' required
openedAtstring date-time nullable
closedAtstring date-time nullable
bidCountinteger required
closesAtstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.