Back to Dashboard
API Discovery
Back to Tools

send_message

write:messaging

Send a message to a customer. Uses their most recent conversation platform if not specified. Returns the message ID and conversation ID.

Input Parameters

Parameters

PropertyTypeDescription
customerIdrequiredstringCustomer UUID
messagerequiredstringMessage content (1-4000 chars)
platformstringPlatform to send on (instagram, facebook, whatsapp, sms, email)

Response

Response Schema

PropertyTypeDescription
conversationIdrequiredstringConversation UUID
messageIdrequiredstringCreated message UUID
platformrequiredstringPlatform message was sent on
sentAtrequiredstringSend timestamp (ISO 8601)

Example

Requestjson
{
  "type": "tool",
  "name": "send_message",
  "params": {
    "customerId": "customer-uuid",
    "message": "Hi! Just a reminder about your appointment tomorrow at 2pm. See you then!"
  }
}
Responsejson
{
  "success": true,
  "data": {
    "conversationId": "conv-uuid",
    "messageId": "msg-uuid",
    "platform": "whatsapp",
    "sentAt": "2024-01-19T10:00:00Z"
  }
}

cURL Example

curl -X POST https://app.bizily.io/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{\n  "type": "tool",\n  "name": "send_message",\n  "params": {\n    "customerId": "customer-uuid",\n    "message": "Hi! Just a reminder about your appointment tomorrow at 2pm. See you then!"\n  }\n}'

Required scope: This tool requires the write:messaging scope. Make sure your API key has this permission enabled in Settings → Developer.