Create a conversation

post

https://api.djfindr.com/prod/v1/me/conversations

Start a chat with a DJ or a client. Needs inbox:write. Send an Idempotency-Key header (required). The body is the input as JSON; where it takes expected_updated_at, send the updated_at you read and a stale edit is 412. Finds it when it already exists: 200 then, 201 when it is made.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Found: it already existed, and nothing new was made

201Created: it did not exist yet

400The body is not a JSON object, or the Idempotency-Key header is missing or not 1 to 255 printable ASCII characters

401Missing, invalid or expired access token

403The token does not hold inbox:write, the account may not do this, or an API key was sent (oauth_required), or a DJ's third-party app without the Platinum plan was used (plan_required)

409Not possible now: the record's state does not allow it, or the Idempotency-Key was used with another body (code says why, such as payouts_not_ready)

412Changed since you read it: the expected_updated_at you sent is not its updated_at any more

422Some of the input is not valid, or a query parameter this request does not take was sent; fields names each

429Rate limited; see Retry-After

503Temporarily unavailable; safe to retry