Ask for a price

Ask our team for the price of an approved creator with nothing on sale (ask_price true and price_estimate on its row; the estimate is never a price). The team prices it, the price then shows on the creator (creator_get offerings) and as a priced answer on your plan, held for you for 48 hours; nothing is booked or charged until you add the creator to a plan and approve it. It reaches our team, never the creator. One open ask per creator: asking again answers already true and sends nothing. Opening the creator counts as one creator opened today (free when already opened). 3 asks for one creator and 20 in all in any 24 hours (rate_limited, reason daily_limit, with retry_after and resets_at saying when that limit reopens). A creator with a format on sale answers conflict, reason already_priced: add it with plan_add_creator. Optionally campaign_id: one of your campaigns the ask is for. Scope: creators:read. No Idempotency-Key: an ask is one open request per creator, so a retry while it is open answers already true; once it is answered or its 48 hours run out, asking again opens a new one. MCP tool: creator_ask_price.

post/creators/{id}/price-request

Request

  • Base URL: https://app.distribution.tech/api/v1
  • URL: https://app.distribution.tech/api/v1/creators/{id}/price-request
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The creator's id from a GET /creators row (a UUID).

Request body

campaign_idstring uuid

One of your campaigns this ask is for; the priced answer then shows on that campaign's plan. Another brand's or an unknown id is dropped.

Response

Asked, or already asked (already true).

creator_idstring uuid required
requestedunknown required
alreadyboolean required

true: an ask for this creator is still open (an earlier call, or a teammate's click in the app); nothing new was sent. An ask is held for 48 hours: once it is answered or expires, the next call opens a new ask and answers already false.

status'requested' | 'priced' required

requested: our team is pricing it. priced: a price is on the creator now (creator_get offerings) and held for you for 48 hours.

requested_atstring date-time required
nextstring required

What happens next, in one sentence.

Changes

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