Sign in
latestOpenAPI 3.1.02026-08-22122113375.9 KB

8258f1357d7f

conversations

Create conversation

Create a conversation and send the first message.

Use this endpoint to start buyer/seller conversations from listing or order context.

Behavior:

  • Creates the conversation and initial message in one request.
  • Sends an email notification when the recipient is inactive.
post/conversations

Request body

recipientIdstring required

User ID of the conversation recipient

bodystring required

Initial message body. Links, emojis and profanity are sanitized.

Response

Conversation created

idstring required

Unique identifier for the conversation

lockedboolean required

Whether the conversation is locked

createdAtstring nullable

Timestamp when the conversation was created

updatedAtstring nullable

Timestamp when the conversation was last updated