Send a message

Send a message on a thread. The channel (email, Slack, live chat, Microsoft Teams) is auto-detected from the thread's origin and the response includes the channel that was used. Returns 400 with code validation_failed when the matching integration is not configured for the workspace. Requires the messages:write scope; Slack replies need the Pro plan and Teams replies the Scale plan.

POST

/api/v2/threads/{thread_id}/messages

POST

/threads/{thread_id}/messages

curl -X POST "https://productlane.com/api/v2/threads/{thread_id}/messages" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "string"
}'

Authorization

Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parameters

thread_id
string
path
required

Body

application/json

content
string
required
Message body (HTML).
cc
object[]
Applied only to email-channel threads.
bcc
object[]
Applied only to email-channel threads.
attachments
object[]
Applied only to email-channel threads.
channel_id
string
Slack channel id. Required for Slack threads unless one is stored on the thread.
author
enum<string>
user (default) sends the message as your workspace user. On a custom thread nothing is delivered: message.sent carries the reply to your integration. contact records the message as inbound from the thread's contact. On email and live chat threads that triggers nothing; on a custom thread it works like an inbound email: the thread reopens, notifications fire and the AI agent may answer. Not supported on Slack and Teams threads.
One of:
user
contact
external_message_id
string
Custom channel threads only: your id for an inbound message. A repeat with the same id returns the stored message and creates nothing.

Response

application/json

Successful response

id
string
required
thread_id
string
required
channel
enum<string>
required
One of:
email
slack
live_chat
teams
custom
custom_channel
string | null
Channel name on a custom thread, such as whatsapp.
deduplicated
boolean
True when external_message_id matched a stored message and nothing new was created.

{
  "id": "string",
  "thread_id": "string",
  "channel": "email",
  "custom_channel": "string",
  "deduplicated": true
}

POST

/threads/{thread_id}/messages

curl -X POST "https://productlane.com/api/v2/threads/{thread_id}/messages" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "string"
}'

{
  "id": "string",
  "thread_id": "string",
  "channel": "email",
  "custom_channel": "string",
  "deduplicated": true
}

APIThreads

Send a message

POST

/api/v2/threads/{thread_id}/messages

POST

/threads/{thread_id}/messages

curl -X POST "https://productlane.com/api/v2/threads/{thread_id}/messages" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "string"
}'

Authorization

Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parameters

thread_id
string
path
required

Body

application/json

content
string
required
Message body (HTML).
cc
object[]
Applied only to email-channel threads.
bcc
object[]
Applied only to email-channel threads.
attachments
object[]
Applied only to email-channel threads.
channel_id
string
Slack channel id. Required for Slack threads unless one is stored on the thread.
author
enum<string>
user (default) sends the message as your workspace user. On a custom thread nothing is delivered: message.sent carries the reply to your integration. contact records the message as inbound from the thread's contact. On email and live chat threads that triggers nothing; on a custom thread it works like an inbound email: the thread reopens, notifications fire and the AI agent may answer. Not supported on Slack and Teams threads.
One of:
user
contact
external_message_id
string
Custom channel threads only: your id for an inbound message. A repeat with the same id returns the stored message and creates nothing.

Response

application/json

Successful response

id
string
required
thread_id
string
required
channel
enum<string>
required
One of:
email
slack
live_chat
teams
custom
custom_channel
string | null
Channel name on a custom thread, such as whatsapp.
deduplicated
boolean
True when external_message_id matched a stored message and nothing new was created.

{
  "id": "string",
  "thread_id": "string",
  "channel": "email",
  "custom_channel": "string",
  "deduplicated": true
}

POST

/threads/{thread_id}/messages

curl -X POST "https://productlane.com/api/v2/threads/{thread_id}/messages" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "string"
}'

{
  "id": "string",
  "thread_id": "string",
  "channel": "email",
  "custom_channel": "string",
  "deduplicated": true
}