POSTapi.synup.com/api/v4/social-post-ideas/send-chat-message
Send chat message
Sends a message to an AI post-idea chat session and returns the assistant's reply. The response may include a generated post idea card (postCard), follow-up action chips, and a series plan when relevant. Optionally attach referenceImageUrls for image-grounded generation.
Requires an API key. Send it as
Authorization: API <your-key> — see Getting started.Parameters
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Synup-Version | string | required | API version date (YYYY-MM-DD). |
Body
| Name | Type | Required | Description |
|---|---|---|---|
sessionId | string | required | |
message | string | required | |
referenceImageUrls | array of string | optional |
Request
Request
curl -X POST 'https://api.synup.com/api/v4/social-post-ideas/send-chat-message' \
-H 'Authorization: API YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"sessionId": "7f3c1a2e-...",
"message": "Give me a post idea for our product launch"
}'const res = await fetch('https://api.synup.com/api/v4/social-post-ideas/send-chat-message', {
method: 'POST',
headers: {
Authorization: 'API YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"sessionId": "7f3c1a2e-...",
"message": "Give me a post idea for our product launch"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://api.synup.com/api/v4/social-post-ideas/send-chat-message",
headers={
"Authorization": "API YOUR_API_KEY",
"Content-Type": "application/json",
},
json={
"sessionId": "7f3c1a2e-...",
"message": "Give me a post idea for our product launch"
},
)
data = res.json()req, _ := http.NewRequest("POST", "https://api.synup.com/api/v4/social-post-ideas/send-chat-message", bytes.NewBufferString(payload))
req.Header.Set("Authorization", "API YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)Responses
| Status | Description |
|---|---|
200 | Successful response |
401 | Unauthorized - Invalid or missing API key |
Example response (generated from the schema)
{
"data": {
"sendChatMessage": {
"success": true,
"message": {
"id": "string",
"role": "string",
"content": "string",
"messageType": "string",
"metadata": {},
"sequence": 0,
"createdAt": "string"
},
"postCard": {},
"seriesPlan": {},
"actionChips": [
{
"label": "string",
"emoji": "string",
"action": "string"
}
],
"error": {
"message": "string",
"code": "string",
"contextInfo": [
{
"key": "string",
"value": "string"
}
]
}
}
}
}Response body
| Name | Type | Required | Description |
|---|---|---|---|
data | object | optional | |
data.sendChatMessage | object | optional | |
data.sendChatMessage.success | boolean | optional | |
data.sendChatMessage.message | object | optional | |
data.sendChatMessage.message.id | string | optional | |
data.sendChatMessage.message.role | string | optional | |
data.sendChatMessage.message.content | string | optional | |
data.sendChatMessage.message.messageType | string | optional | |
data.sendChatMessage.message.metadata | object | optional | |
data.sendChatMessage.message.sequence | integer | optional | |
data.sendChatMessage.message.createdAt | string | optional | |
data.sendChatMessage.postCard | object | optional | Generated post idea card (see Post idea for the full shape), when produced. |
data.sendChatMessage.seriesPlan | object | optional | Content-series plan, when produced. |
data.sendChatMessage.actionChips | array of object | optional | |
data.sendChatMessage.actionChips[].label | string | optional | |
data.sendChatMessage.actionChips[].emoji | string | optional | |
data.sendChatMessage.actionChips[].action | string | optional | |
data.sendChatMessage.error | object | optional | |
data.sendChatMessage.error.message | string | optional | |
data.sendChatMessage.error.code | string | optional | |
data.sendChatMessage.error.contextInfo | array of object | optional | |
data.sendChatMessage.error.contextInfo[].key | string | optional | |
data.sendChatMessage.error.contextInfo[].value | string | optional |