Skip to main content
POST
/
:projectId
/
api
/
v7
/
conversations
/
direct
Create Direct Conversation
curl --request POST \
  --url https://api.replyke.com/api/v6/:projectId/api/v7/conversations/direct \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": "<string>"
}
'
Returns an existing DM between the caller and the target user, or creates one if it does not yet exist. Only one direct conversation can exist per user pair per project — this endpoint is idempotent. Returns 201 when a new conversation was created, 200 when an existing one was found.

Body Parameters

userId
string
required
The ID of the user to start a direct conversation with. Must belong to the same project.

Response

Returns a Conversation object with type: "direct".
Direct conversations cannot be updated or deleted, and members cannot leave them. They persist as long as either user’s account exists.

Error Responses

{ "error": "Target user does not belong to this project.", "code": "chat/invalid-member" }