Skip to main content
Use this endpoint to send a message into an active conversation as a human seller, bypassing the AI agent entirely. This is the right call when a sales advisor wants to step in at a critical moment — such as discussing financing, handling a price negotiation, or closing a deal — without waiting for the AI to respond first. You can optionally pause the AI agent for that conversation so it stays out of the way while your team handles the exchange directly.

​
Endpoint

​
Path Parameters

​
string
required
The unique identifier of the conversation to send the message into, e.g. conv_xyz789. The conversation must have a status of open.

​
Request Body

​
string
required
The text body of the message to send. Must be a non-empty string. Markdown formatting is not rendered on the recipient’s device — send plain text.
​
string
default:"text"
Media type of the message. Accepted values: text, image, document. For image and document, content must be a publicly accessible URL to the file. Defaults to text.
​
boolean
default:"false"
When true, pauses the AI agent for this conversation immediately after sending the message. The AI will not generate any further automatic responses until you resume it from the DeltaLead dashboard or via the Resume AI API endpoint. Defaults to false.

​
Example Request

cURL

​
Response

A successful request returns HTTP 201 Created with the created message object.
201 Created

​
Response Fields

​
string
Unique identifier of the newly created message, prefixed with msg_.
​
string
ID of the conversation the message was sent into.
​
string
Always outbound for messages sent via this endpoint.
​
string
Media type of the message as specified in the request. One of text, image, document.
​
string
The message content as sent — text body or media URL.
​
string
Always human for messages sent via this endpoint, distinguishing them from AI-generated responses in the conversation history.
​
string
ISO 8601 timestamp of when the message was delivered.
Sending a message with pause_ai: true immediately stops the AI agent from auto-responding in this conversation. The lead will not receive any further automated replies until the AI is resumed. To resume the AI agent, use the Resume AI toggle in the DeltaLead dashboard (open the conversation and click Resume AI) or call the Resume AI endpoint. Leaving the AI paused on a high-volume day can result in missed leads, so always resume the agent once your manual interaction is complete.