Conversations

Reply to a conversation

Adds a reply to an existing conversation. Supports both contact (customer/lead) and admin replies.

POST

/v2/conversations/{id}/reply

curl --request POST \
  --url https://do.featurebase.app/v2/conversations/{id}/reply \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bodyMarkdown": "Thank you for your help!",
  "id": "676f0f6765bdaa7d7d760f88",
  "messageType": "reply",
  "skipNotifications": false,
  "type": "contact",
  "userId": "user_123"
}
'

{
  "author": {
    "email": "john@example.com",
    "id": "676f0f6765bdaa7d7d760f88",
    "name": "John Doe",
    "profilePicture": "https://cdn.example.com/avatars/user.png",
    "type": "customer"
  },
  "bodyHtml": "<p>Hello, I have a question about your product.</p>",
  "bodyMarkdown": "Hello, I have a question about your product.",
  "channel": "desktop",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "id": "1",
  "object": "conversation_part",
  "partType": "user_msg",
  "redacted": false,
  "slack": {
    "channelId": "C01EFGH",
    "messageTs": "1705313410.001200",
    "teamId": "T01ABCD",
    "threadTs": "1705313400.001100"
  },
  "tagApplications": [
    {
      "appliedAt": "2025-01-15T10:30:00.000Z",
      "appliedBy": {
        "id": "507f1f77bcf86cd799439011",
        "name": "John Doe",
        "type": "admin"
      },
      "removedAt": "2025-01-15T11:00:00.000Z",
      "removedBy": {
        "id": "507f1f77bcf86cd799439011",
        "name": "John Doe",
        "type": "admin"
      },
      "tag": {
        "id": "67ec1234abcd5678ef901234",
        "name": "Churn",
        "type": "tag"
      },
      "tagId": "67ec1234abcd5678ef901234"
    }
  ],
  "updatedAt": "2025-01-15T10:30:00.000Z"
}

Path Parameters

id - The conversation ID (short ID)

Request Body

The request body varies based on who is sending the reply:

Contact Reply (customer/lead)

Field	Type	Required	Description
`type`	string	Yes	Must be "contact"
`userId`	string	No*	External user ID from your system
`id`	string	No*	Featurebase contact ID (24-character ObjectId)
`bodyMarkdown`	string	Yes	The message content in markdown format. Images referenced by URL or as base64 data URIs will be automatically uploaded and stored.
`messageType`	string	Yes	Must be "reply"
`skipNotifications`	boolean	No	Skip sending notifications (default: false). Useful for bulk imports.

*At least one of userId or id is required.

Admin Reply

Field	Type	Required	Description
`type`	string	Yes	Must be "admin"
`id`	string	Yes	Featurebase admin ID (24-character ObjectId)
`bodyMarkdown`	string	Yes	The message content in markdown format. Images referenced by URL or as base64 data URIs will be automatically uploaded and stored.
`messageType`	string	Yes	"reply" for customer-visible reply, "note" for internal note
`skipNotifications`	boolean	No	Skip sending notifications (default: false). Useful for bulk imports.

Response

Returns the created conversation part object with a 201 Created status. The response includes both bodyHtml (with signed image URLs) and bodyMarkdown fields.

Example Contact Reply

{
  "type": "contact",
  "userId": "user_123",
  "bodyMarkdown": "Thank you for your help!",
  "messageType": "reply"
}

Example Admin Reply

{
  "type": "admin",
  "id": "507f1f77bcf86cd799439011",
  "bodyMarkdown": "I'm happy to help! Here's what you need to do...",
  "messageType": "reply"
}

Example Admin Note (Internal)

{
  "type": "admin",
  "id": "507f1f77bcf86cd799439011",
  "bodyMarkdown": "Customer seems frustrated, escalating to tier 2.",
  "messageType": "note"
}

Example Response

{
  "object": "conversation_part",
  "id": "3",
  "partType": "user_msg",
  "bodyHtml": "<p>Thank you for your help!</p>",
  "bodyMarkdown": "Thank you for your help!",
  "author": {
    "type": "customer",
    "id": "676f0f6765bdaa7d7d760f88",
    "name": "John Doe",
    "email": "john@example.com"
  },
  "channel": "desktop",
  "createdAt": "2025-01-15T10:40:00.000Z",
  "updatedAt": "2025-01-15T10:40:00.000Z"
}