Posts
Publish now or schedule up to 90 days ahead on Instagram, Facebook Pages, TikTok and LinkedIn.
Every post goes through one queue, on your own channels and on the ones your customers connect, with the same key. It shows on the Posts screen of the dashboard, and you get an event when it goes out or fails. YouTube videos are scheduled in YouTube itself.
A published post deleted on Instagram or Facebook gets deleted_on_network_at once the Posts screen finds it gone. It still counts as published.
Create a post
POST/api/v1/channels/{id}/posts
The channel id comes from List channels. Leave out publish_at to post now.
| Parameter | Where | Type | Meaning |
|---|---|---|---|
idrequired | path | uuid | The channel's id. |
Idempotency-Key | header | string | A retried request returns the same post instead of posting twice. |
text | body | string | The caption or message. |
media | body | array | { url, type } with type image or video, or { media_id } from Upload media. A scheduled post's files are copied when it is scheduled, so the link only has to work now. Images up to 30 MB, videos up to 1 GB. |
publish_at | body | ISO 8601 with offset | At least a minute from now and at most 90 days ahead. Left out: now. |
link | body | { url, title } | Facebook link posts and LinkedIn articles (LinkedIn needs the title). |
ig_type | body | IMAGE | CAROUSEL | REELS | STORIES | Instagram; worked out from the media when left out. |
title | body | string | TikTok photo posts, up to 90 characters. |
disable_comment | body | boolean | TikTok. |
image_alt | body | string | LinkedIn. |
Request
curl -X POST https://easycoexistence.com/api/v1/channels/<channel_id>/posts \
-H "Authorization: Bearer ec_live_..." -H "Content-Type: application/json" \
-H "Idempotency-Key: 5f0c9a52-launch-friday" \
-d '{
"text": "New collection is in",
"media": [{ "url": "https://example.com/new-collection.jpg", "type": "image" }],
"publish_at": "2026-11-06T09:00:00-03:00"
}'Response 201
{
"id": "0b7e…",
"channel_id": "9a41…",
"channel": "instagram",
"status": "scheduled",
"publish_at": "2026-11-06T12:00:00.000Z",
"source": "api",
"text": "New collection is in",
"media": [
{
"type": "image",
"media_id": "c2d9…"
}
],
"permalink": null,
"error": null,
"failure_kind": null,
"may_be_published": false,
"created_at": "2026-10-30T14:05:11.000Z",
"published_at": null,
"deleted_on_network_at": null
}A post for now that the network refused answers 422, with the post and its error.
- Instagram: an image or a video, JPEG images only, no links. A carousel takes 2 to 10 items.
- Facebook Pages: text, a link, one image or one video.
- TikTok: one video, or 1 to 35 JPEG or WebP images. No links.
- LinkedIn: text, with one image (JPG, PNG or GIF) or a link. No video.
Errors besides the common ones: not_found, invalid_media, channel_unavailable, billing_required.
Upload media
POST/api/v1/media
The file as the body (with Content-Type and Content-Length), or { "url": "https://..." } to have us copy it. Answers a media_id for media on a post, kept 48 hours until a post uses it.
Request
curl -X POST https://easycoexistence.com/api/v1/media \
-H "Authorization: Bearer ec_live_..." -H "Content-Type: image/jpeg" \
--data-binary @new-collection.jpgResponse 201
{
"media_id": "c2d9…",
"type": "image",
"content_type": "image/jpeg",
"bytes": 418233,
"expires_at": "…"
}Errors besides the common ones: invalid_media.
List posts
GET/api/v1/posts
The queue across every channel: upcoming first, or newest first when the filter has no upcoming status.
| Parameter | Where | Type | Meaning |
|---|---|---|---|
status | query | comma list | scheduled, publishing, processing, published, failed, canceled. |
from | query | ISO date | publish_at on or after. |
to | query | ISO date | publish_at before. |
limit | query | number | Default 50. |
external_ref | query | string | Partners: keeps the ones a customer connected, by the external_ref of their connect session. |
Response 200
{
"data": [
{
"id": "0b7e…",
"channel_id": "9a41…",
"channel": "instagram",
"status": "scheduled",
"publish_at": "2026-11-06T12:00:00.000Z",
"source": "api",
"text": "New collection is in",
"media": [
{
"type": "image",
"media_id": "c2d9…"
}
],
"permalink": null,
"error": null,
"failure_kind": null,
"may_be_published": false,
"created_at": "2026-10-30T14:05:11.000Z",
"published_at": null,
"deleted_on_network_at": null
}
]
}processing means the network is still working on a video. A failed post says why in failure_kind: refused, uncertain, reconnect (the channel needs to be connected again), rate_limited (we retried after 5 minutes, 30 minutes and 2 hours first), or internal (an error on our side before anything was sent: nothing is live, retry it).
List a channel's posts
GET/api/v1/channels/{id}/posts
The same list, for one channel.
| Parameter | Where | Type | Meaning |
|---|---|---|---|
idrequired | path | uuid | The channel's id. |
status | query | comma list | As above. |
limit | query | number | Default 50. |
Errors besides the common ones: not_found.
Get a post
GET/api/v1/posts/{id}
One post, with permalink once it is published.
| Parameter | Where | Type | Meaning |
|---|---|---|---|
idrequired | path | uuid | The post's id. |
Response 200
{
"id": "0b7e…",
"channel_id": "9a41…",
"channel": "instagram",
"status": "scheduled",
"publish_at": "2026-11-06T12:00:00.000Z",
"source": "api",
"text": "New collection is in",
"media": [
{
"type": "image",
"media_id": "c2d9…"
}
],
"permalink": null,
"error": null,
"failure_kind": null,
"may_be_published": false,
"created_at": "2026-10-30T14:05:11.000Z",
"published_at": null,
"deleted_on_network_at": null
}Errors besides the common ones: not_found.
Change a scheduled post
PATCH/api/v1/posts/{id}
While it is still scheduled. To change the media, cancel it and create a new one.
| Parameter | Where | Type | Meaning |
|---|---|---|---|
idrequired | path | uuid | The post's id. |
publish_at | body | ISO 8601 with offset | |
text | body | string | |
title | body | string |
Request
{
"publish_at": "2026-11-07T09:00:00-03:00"
}Response 200
{
"id": "0b7e…",
"channel_id": "9a41…",
"channel": "instagram",
"status": "scheduled",
"publish_at": "2026-11-07T12:00:00.000Z",
"source": "api",
"text": "New collection is in",
"media": [
{
"type": "image",
"media_id": "c2d9…"
}
],
"permalink": null,
"error": null,
"failure_kind": null,
"may_be_published": false,
"created_at": "2026-10-30T14:05:11.000Z",
"published_at": null,
"deleted_on_network_at": null
}Cancel a post
DELETE/api/v1/posts/{id}
Cancels a post that has not gone out. A published post is not deleted from the network.
| Parameter | Where | Type | Meaning |
|---|---|---|---|
idrequired | path | uuid | The post's id. |
Response 200
{
"id": "0b7e…",
"channel_id": "9a41…",
"channel": "instagram",
"status": "canceled",
"publish_at": "2026-11-06T12:00:00.000Z",
"source": "api",
"text": "New collection is in",
"media": [
{
"type": "image",
"media_id": "c2d9…"
}
],
"permalink": null,
"error": null,
"failure_kind": null,
"may_be_published": false,
"created_at": "2026-10-30T14:05:11.000Z",
"published_at": null,
"deleted_on_network_at": null
}Retry a failed post
POST/api/v1/posts/{id}/retry
Tries a failed post again. When may_be_published is true the network may have received it before the error: look at the account first, then send { "confirm": true }, or it may go out twice.
| Parameter | Where | Type | Meaning |
|---|---|---|---|
idrequired | path | uuid | The post's id. |
confirm | body | true | Needed when may_be_published is true. |
Request
{
"confirm": true
}Response 200
{
"id": "0b7e…",
"channel_id": "9a41…",
"channel": "instagram",
"status": "publishing",
"publish_at": "2026-11-06T12:00:00.000Z",
"source": "api",
"text": "New collection is in",
"media": [
{
"type": "image",
"media_id": "c2d9…"
}
],
"permalink": null,
"error": null,
"failure_kind": null,
"may_be_published": false,
"created_at": "2026-10-30T14:05:11.000Z",
"published_at": null,
"deleted_on_network_at": null
}