curl --request POST \
--url https://monitor.solobiz.academy/api/open/v1/posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"channel_ids": [
"1000000000000001"
],
"content": "Test post content",
"id_thirdparty": "demo-fb-0001",
"media": {
"type": 1,
"images": [
{
"url": "https://cdn.example.com/photo-1.jpg"
}
]
},
"scheduled_at": 1795000000,
"comment_seedings": {
"comments": [
{
"message": "First comment",
"extra_time": 1
}
]
}
}
'{
"success": true,
"message": "Operation successful",
"data": {
"post_id": "<string>",
"duplicate": true,
"targets": [
{
"channel_id": "<string>",
"platform": "facebook",
"status": "pending",
"permalink": "<string>",
"platform_post_id": "<string>",
"published_at": "2023-11-07T05:31:56Z",
"deleted_at": "2023-11-07T05:31:56Z",
"warning": "<string>",
"error": {
"kind": "<string>",
"code": "<string>",
"subcode": "<string>",
"message": "<string>"
}
}
]
},
"timestamp": "2023-11-07T05:31:56Z",
"meta": {}
}{
"success": true,
"message": "Operation successful",
"data": {
"post_id": "66a1b2c3d4e5f60718293a4b",
"duplicate": false,
"targets": [
{
"channel_id": "1000000000000001",
"platform": "facebook",
"status": "pending",
"permalink": null,
"platform_post_id": null,
"published_at": null,
"deleted_at": null,
"warning": null,
"error": null
}
]
},
"meta": null,
"timestamp": "2026-11-19T00:00:00.000Z"
}{
"success": false,
"error": {
"message": "content must not be empty",
"code": "invalid_content",
"issues": [
{
"code": "invalid_content",
"message": "content must not be empty"
}
]
},
"timestamp": "2026-11-19T00:00:00.000Z"
}{
"success": false,
"error": {
"message": "<string>",
"code": "<string>",
"issues": [
{
"code": "<string>",
"message": "<string>"
}
],
"retry_after_seconds": 123
},
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"message": "Insufficient workspace role",
"code": "ForbiddenException"
},
"timestamp": "2026-11-19T00:00:00.000Z"
}{
"success": false,
"error": {
"message": "<string>",
"code": "<string>",
"issues": [
{
"code": "<string>",
"message": "<string>"
}
],
"retry_after_seconds": 123
},
"timestamp": "2023-11-07T05:31:56Z"
}Posts
Queue a post
⚠️ Live action - this publishes to real social channels on production (when the server has publishing enabled) and cannot be undone from the API for Facebook and Instagram.
Queues one post on one or more channels; each channel becomes a pending target. Everything is validated before anything is written: on error nothing is created.
201new post (duplicate: false).200id_thirdpartywas already used in the workspace: returns the existing post withduplicate: true, creates nothing. Retry a lost response with the sameid_thirdparty.scheduled_atomitted,nullor in the past publishes immediately; more than 30 days ahead gives 400invalid_scheduled_at(usually milliseconds sent instead of seconds).- The API does not accept file uploads: media must be a public
httpsURL. - Check order: body shape, duplicate
id_thirdparty(200), channels. - Validation failures carry
error.issues[](every reason,{ code, message });error.codeis the first one.
Platform rules (checked per channel): Facebook feed / reel; Instagram needs media (jpg/jpeg images, or video / reel), caption up to 2200 chars; Threads up to 500 chars, images jpg/jpeg/png, up to 20 in a carousel; YouTube needs exactly one video.
Required role: editor.
POST
/
posts
curl --request POST \
--url https://monitor.solobiz.academy/api/open/v1/posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"channel_ids": [
"1000000000000001"
],
"content": "Test post content",
"id_thirdparty": "demo-fb-0001",
"media": {
"type": 1,
"images": [
{
"url": "https://cdn.example.com/photo-1.jpg"
}
]
},
"scheduled_at": 1795000000,
"comment_seedings": {
"comments": [
{
"message": "First comment",
"extra_time": 1
}
]
}
}
'{
"success": true,
"message": "Operation successful",
"data": {
"post_id": "<string>",
"duplicate": true,
"targets": [
{
"channel_id": "<string>",
"platform": "facebook",
"status": "pending",
"permalink": "<string>",
"platform_post_id": "<string>",
"published_at": "2023-11-07T05:31:56Z",
"deleted_at": "2023-11-07T05:31:56Z",
"warning": "<string>",
"error": {
"kind": "<string>",
"code": "<string>",
"subcode": "<string>",
"message": "<string>"
}
}
]
},
"timestamp": "2023-11-07T05:31:56Z",
"meta": {}
}{
"success": true,
"message": "Operation successful",
"data": {
"post_id": "66a1b2c3d4e5f60718293a4b",
"duplicate": false,
"targets": [
{
"channel_id": "1000000000000001",
"platform": "facebook",
"status": "pending",
"permalink": null,
"platform_post_id": null,
"published_at": null,
"deleted_at": null,
"warning": null,
"error": null
}
]
},
"meta": null,
"timestamp": "2026-11-19T00:00:00.000Z"
}{
"success": false,
"error": {
"message": "content must not be empty",
"code": "invalid_content",
"issues": [
{
"code": "invalid_content",
"message": "content must not be empty"
}
]
},
"timestamp": "2026-11-19T00:00:00.000Z"
}{
"success": false,
"error": {
"message": "<string>",
"code": "<string>",
"issues": [
{
"code": "<string>",
"message": "<string>"
}
],
"retry_after_seconds": 123
},
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"message": "Insufficient workspace role",
"code": "ForbiddenException"
},
"timestamp": "2026-11-19T00:00:00.000Z"
}{
"success": false,
"error": {
"message": "<string>",
"code": "<string>",
"issues": [
{
"code": "<string>",
"message": "<string>"
}
],
"retry_after_seconds": 123
},
"timestamp": "2023-11-07T05:31:56Z"
}Ủy quyền
Nội dung
application/json

