conversations_send_a_new_message
Send a new message to a contact via SMS, email, WhatsApp, and more. Specify message type, content, and recipient to communicate directly from your GHL CRM.
Instructions
Send a new message
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"type": "<type>",
"subType": "<subType>",
"contactId": "<contactId>",
"status": "<status>"
},
"name": "conversations_send_a_new_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| html | No | HTML content of the message | |
| type | Yes | Type of message being sent | |
| status | Yes | Message status | |
| emailCc | No | Array of CC email addresses | |
| emailTo | No | Email address to send to, if different from contact's primary email. This should be a valid email address associated with the contact. | |
| forward | No | Forwarding configuration for emails | |
| message | No | Text content of the message | |
| subType | Yes | Type of message being sent | |
| subject | No | Subject line for email messages | |
| emailBcc | No | Array of BCC email addresses | |
| threadId | No | ID of message thread. For email messages, this is the message ID that contains multiple email messages in the thread | |
| toNumber | No | Recipient phone number for outbound messages | |
| contactId | Yes | ID of the contact receiving the message | |
| emailFrom | No | Email address to send from | |
| fromNumber | No | Phone number used as the sender number for outbound messages | |
| templateId | No | ID of message template | |
| attachments | No | Array of attachment URLs | |
| appointmentId | No | ID of the associated appointment | |
| emailReplyMode | No | Mode for email replies | |
| replyMessageId | No | ID of message being replied to | |
| customSubtypeId | No | Custom subtype ID for email unsubscription preferences. Only applies to email messages. | |
| optimizationPeriod | No | Optimization period in hours (24h, 48h, or 72h) | |
| scheduledTimestamp | No | UTC Timestamp (in seconds) at which the message should be scheduled | |
| conversationProviderId | No | ID of conversation provider | |
| usesNativeSchedulingAi | No | Whether the scheduled email uses native AI for the email scheduling |