Conversations
Send a message with an attachment
Sends a message into the conversation with a file attachment. Unlike the plain messages endpoint, this variant uses application/x-www-form-urlencoded (form fields) rather than a JSON body, so the message text and message options are submitted as form parameters alongside the attachment reference. Returns the same created-message object shape as the JSON send endpoint, including the resulting attachments array. Use this when a reply needs to include an image, document, or other file.
curl --request POST \
--url 'https://api.nabrah.ai/api/ext/omni_v2/conversation/conversation/<id>/messages_with_attachment' \
--header 'X-API-Key: <your-api-key>'{
"content": "string",
"content_attributes": {},
"content_type": "string",
"conversation_id": 0,
"created_at": 0,
"echo_id": "string",
"id": 0,
"inbox_id": 0,
"message_type": 0,
"private": false,
"sender": {
"id": 0,
"name": "string",
"available_name": "string",
"avatar_url": "string",
"type": "string"
},
"source_id": "string",
"status": "string",
"attachments": [
{
"id": 0,
"account_id": 0,
"message_id": 0,
"thumb_url": "string",
"data_url": "string",
"file_size": 0,
"file_type": "string",
"extension": "string",
"width": 0,
"height": 0,
"created_at": 0,
"sender": {
"id": 0,
"name": "string",
"available_name": "string",
"avatar_url": "string",
"type": "string",
"availability_status": "string",
"thumbnail": "string",
"additional_attributes": {},
"custom_attributes": {},
"email": "string",
"identifier": "string",
"phone_number": "string",
"blocked": false
},
"coordinates_lat": 0,
"coordinates_lng": 0,
"fallback_title": "string",
"meta": {}
}
]
}Form-encoded request
This endpoint does not accept JSON.
Content-TypeSubmit the body as application/x-www-form-urlencoded. The message fields (such as content and message type) are sent as form fields rather than a JSON object, together with the attachment payload.
Use this endpoint whenever the outgoing message carries a file. For text-only messages, internal notes, or templated content, use the JSON POST.../{id}/messages endpoint instead.
Because the content type is form-urlencoded, the Try-it panel does not show a JSON body variant for this operation.
Instagram and TikTok reply windows
Outgoing messages on Instagram and TikTok conversations are only delivered inside the platform's reply window.
Returned when the window has closed: 24 hours after the customer's last message on Instagram, 48 hours on TikTok. Private notes are not affected. On Instagram, team members replying from the platform can still reply for up to 7 days; API sends cannot.
If the platform refuses a message after it was accepted, a private note starting with "Not delivered" is added to the conversation.
Authorization
X-API-KeystringheaderrequiredYour workspace API key. Create one in the dashboard under API keys.
Path parameters
idintegerrequiredInteger id of the conversation to post the message into.
From a list endpoint or GET.../conversation/{id}.
Body
application/x-www-form-urlencodedResponse
Successful Response
application/json
Validation Error
application/json