Skip to main content
POST
/
v1
/
send-message
/
{company_id}
/
{conversation_id}
Send a message in a conversation
curl --request POST \
  --url https://api.salescaptain.com/v1/send-message/{company_id}/{conversation_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message_body": "Hi — this is a test message from the api-doc send endpoint."
}
'
{
  "message": "Message sent successfully!",
  "data": {
    "conversation_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "author": "Jane Doe",
    "body": "Hi — this is a test message from the api-doc send endpoint.",
    "date_created": "2025-03-23T18:30:00.000Z",
    "is_me": true,
    "message_type": "sms_message",
    "sent_by_id": "d4e5f6a7-b8c9-0123-def1-234567890123",
    "sent_by_username": "Jane Doe",
    "message_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Authorizations

​
Authorization
string
header
required

Authentication token required for accessing protected endpoints. The token should be obtained from the main SalesCaptain authentication service.

Path Parameters

​
company_id
string<uuid>
required

Unique identifier for the company

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
conversation_id
string<uuid>
required

Unique identifier for the conversation

Example:

"b2c3d4e5-f6a7-8901-bcde-f12345678901"

Body

application/json
​
message_body
string
required

Plain text body of the message to send

Example:

"Hi — this is a test message from the api-doc send endpoint."

Response

Message sent successfully

​
message
string
Example:

"Message sent successfully!"

​
data
object

Message as returned after a successful send (chat service response)