A Content Studio post is a caption and up to 20 photos and videos from the store's Content Studio library that Tringify publishes to Instagram and the store's Facebook Page. Instagram's API cannot schedule, so Tringify keeps the schedule itself and publishes directly to Meta at scheduled_at, up to schedule_max_days ahead. Reads require read_marketing; creating, changing, publishing, cancelling and deleting require write_marketing. The merchant connects Instagram and Facebook in Store Admin › Settings; GET /social-posts/channels says which channels are connected.
Every post is checked against each chosen channel's rules before it is scheduled or published: Meta's current limits, listed under rules in GET /social-posts/limits (Instagram: JPEG photos up to 8 MB between 4:5 and 1.91:1, MP4 or MOV videos of 3 seconds to 15 minutes up to 300 MB, carousels of up to 20 items, captions up to 2,200 characters with at most 30 hashtags and 20 @mentions, 50 API posts per account in 24 hours; Facebook: text, up to 10 photos, or one video). POST /social-posts/validate returns the same issues without saving; scheduling a post that breaks a rule returns SOCIAL_POST_CHANNEL_RULES with them in details.issues.
Each post has one targets entry per channel with its own status, external_id, permalink and, when it failed, error_code and error_message. A channel that fails for a passing reason (Meta unavailable, rate limits) is retried after 1, 5, 15 and 60 minutes, up to max_attempts; one Meta refuses, or whose files were deleted from the library, fails at once. The post's status follows its channels: draft, scheduled, publishing (also while a channel waits to retry), published, partially_failed, failed or cancelled. When every channel has finished, social_posts/published fires if one published and social_posts/failed if one failed, and the store is notified of a failure. Bulk cancel and delete apply in one transaction and skip posts they do not apply to.
Endpoints#
List Content Studio channels
List the channels a post can go to.
Returns instagram and facebook_page with connected, the connected account's account_name and connection_status: connected, needs_reconnect, awaiting_page (the merchant signed in with Meta but has not chosen a Page yet), not_connected or unavailable. The merchant connects them in Store Admin › Settings › Integrations. A post can only be scheduled to connected channels.
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
List social posts
List posts for a date range or by status.
Returns posts whose scheduled (or published) time falls in from–to, earliest first, or every post with a status when no range is given. A draft without a time is listed only without a range. Each post carries its targets, one per channel, with that channel's own status, link and error.
Query parameters
| Name | Type | Description |
|---|---|---|
from
|
datetime |
Start of the range (inclusive). With |
to
|
datetime |
End of the range (exclusive). |
status
|
string |
Only posts with this status.
Allowed values
draftscheduledpublishingpublishedpartially_failedfailedcancelled |
cursor
|
string |
Use next_cursor from the previous page with unchanged filters. Invalid or stale cursors return INVALID_INPUT on cursor; restart from the first page. |
limit
|
integer |
Page size, 1 to 100 ( |
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Errors
-
400VALIDATION_LIST_INVALID_LIMITLimit is not between 1 and
list_max_limit. -
400INVALID_INPUTcursoris invalid or stale, orfrom/tois not an RFC 3339 time. -
400SOCIAL_POST_RANGE_INVALIDtois not afterfrom, only one was sent, or the range is longer thanrange_max_days. -
400SOCIAL_POST_STATUS_INVALIDStatus is not one of
status_options. -
400STORE_API_QUERY_PARAMETER_UNKNOWNThe query string has a parameter this request does not accept. The message and
error.details.allowed_parameterslist the ones it does.
Get a social post
Fetch one post.
Returns the post with its targets and version (send it back when updating).
Path parameters
| Name | Type | Description |
|---|---|---|
id
required
|
uuid |
Social post id. |
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Errors
-
400SOCIAL_POST_ID_INVALIDPost id is not a valid UUID.
-
404NOT_FOUNDPost does not exist in this store.
Check a social post
Check a post against each channel's rules without saving it.
Returns issues: one entry per broken rule with its channel, code, message and, for a file, its position in media_file_ids. An empty list means the post can be scheduled.
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Body parameters
| Name | Type | Description |
|---|---|---|
caption
|
string |
Post text, up to 5000 characters. Instagram takes at most 2200. |
media_file_ids
|
array<uuid> |
Content Studio library photos and videos in post order, up to 20. Several make a carousel on Instagram and a multi-photo post on Facebook. |
channels
required
|
array<string> |
|
scheduled_at
|
datetime |
RFC 3339 time it would publish at; checks Instagram's 24-hour limit around it. |
Errors
-
400STORE_API_INVALID_REQUEST_BODYRequest body is not a JSON object.
-
400SOCIAL_POST_CAPTION_TOO_LONGCaption is longer than
caption_max_length. -
400SOCIAL_POST_CHANNELS_REQUIREDNo channel was chosen.
-
400SOCIAL_POST_CHANNEL_INVALIDA channel is not instagram or facebook_page.
-
409SOCIAL_POST_CHANNEL_NOT_CONNECTEDA chosen channel is not connected (only when scheduling or publishing).
-
400SOCIAL_POST_MEDIA_TOO_MANYMore files than
media_max_items. -
400SOCIAL_POST_MEDIA_INVALIDA file is not in the store's Content Studio library or is not a photo or video;
details.positionsays which. -
503SOCIAL_POST_MEDIA_UNAVAILABLEThe library could not be reached; nothing was saved. Try again.
-
400SOCIAL_POST_SCHEDULE_REQUIREDactionisschedulewithoutscheduled_at. -
400SOCIAL_POST_SCHEDULE_PASTscheduled_atis not in the future. -
400SOCIAL_POST_SCHEDULE_TOO_FARscheduled_atis more thanschedule_max_daysahead. -
400SOCIAL_POST_CHANNEL_RULESThe post breaks a channel's rules;
details.issueslists each one as validate returns it. -
400STORE_API_BODY_PROPERTY_UNKNOWNThe body has a property this request does not accept. The message and
error.details.propertieslist the allowed and required properties (nestedfor each object or list of objects). -
400STORE_API_BODY_PROPERTY_INVALIDA body property has the wrong type (
error.details.expected_type). The message anderror.details.propertieslist the allowed and required properties.
Create a social post
Save a draft, schedule a post or publish it now.
action decides what happens: draft saves it without a time, schedule publishes it at scheduled_at (at most 92 days ahead), publish_now publishes it straight away. Scheduling or publishing checks every channel's rules first and returns SOCIAL_POST_CHANNEL_RULES with details.issues when the post breaks one. Tringify runs the schedule and publishes directly to Meta; a channel that fails for a passing reason is retried up to max_attempts times.
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Body parameters
| Name | Type | Description |
|---|---|---|
caption
|
string |
Post text, up to 5000 characters. Instagram takes at most 2200. |
media_file_ids
|
array<uuid> |
Content Studio library photos and videos in post order, up to 20. Several make a carousel on Instagram and a multi-photo post on Facebook. |
channels
required
|
array<string> |
|
action
required
|
string |
Allowed values
draftschedulepublish_now |
scheduled_at
|
datetime |
RFC 3339 time to publish at; required for |
Errors
-
400STORE_API_INVALID_REQUEST_BODYRequest body is not a JSON object.
-
400SOCIAL_POST_CAPTION_TOO_LONGCaption is longer than
caption_max_length. -
400SOCIAL_POST_CHANNELS_REQUIREDNo channel was chosen.
-
400SOCIAL_POST_CHANNEL_INVALIDA channel is not instagram or facebook_page.
-
409SOCIAL_POST_CHANNEL_NOT_CONNECTEDA chosen channel is not connected (only when scheduling or publishing).
-
400SOCIAL_POST_MEDIA_TOO_MANYMore files than
media_max_items. -
400SOCIAL_POST_MEDIA_INVALIDA file is not in the store's Content Studio library or is not a photo or video;
details.positionsays which. -
503SOCIAL_POST_MEDIA_UNAVAILABLEThe library could not be reached; nothing was saved. Try again.
-
400SOCIAL_POST_SCHEDULE_REQUIREDactionisschedulewithoutscheduled_at. -
400SOCIAL_POST_SCHEDULE_PASTscheduled_atis not in the future. -
400SOCIAL_POST_SCHEDULE_TOO_FARscheduled_atis more thanschedule_max_daysahead. -
400SOCIAL_POST_CHANNEL_RULESThe post breaks a channel's rules;
details.issueslists each one as validate returns it. -
400STORE_API_BODY_PROPERTY_UNKNOWNThe body has a property this request does not accept. The message and
error.details.propertieslist the allowed and required properties (nestedfor each object or list of objects). -
400STORE_API_BODY_PROPERTY_INVALIDA body property has the wrong type (
error.details.expected_type). The message anderror.details.propertieslist the allowed and required properties.
Update a social post
Change a draft, scheduled or failed post.
Replaces the caption, media, channels and time, then applies action as on create. A post that is publishing or published cannot be changed. Send the version you read; a post that changed since returns SOCIAL_POST_VERSION_CONFLICT.
Path parameters
| Name | Type | Description |
|---|---|---|
id
required
|
uuid |
Social post id. |
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Body parameters
| Name | Type | Description |
|---|---|---|
caption
|
string |
Post text, up to 5000 characters. Instagram takes at most 2200. |
media_file_ids
|
array<uuid> |
Content Studio library photos and videos in post order, up to 20. Several make a carousel on Instagram and a multi-photo post on Facebook. |
channels
required
|
array<string> |
|
action
required
|
string |
Allowed values
draftschedulepublish_now |
scheduled_at
|
datetime |
RFC 3339 time to publish at; required for |
version
required
|
integer |
The post's |
Errors
-
400SOCIAL_POST_ID_INVALIDPost id is not a valid UUID.
-
404NOT_FOUNDPost does not exist in this store.
-
400STORE_API_INVALID_REQUEST_BODYRequest body is not a JSON object.
-
400SOCIAL_POST_CAPTION_TOO_LONGCaption is longer than
caption_max_length. -
400SOCIAL_POST_CHANNELS_REQUIREDNo channel was chosen.
-
400SOCIAL_POST_CHANNEL_INVALIDA channel is not instagram or facebook_page.
-
409SOCIAL_POST_CHANNEL_NOT_CONNECTEDA chosen channel is not connected (only when scheduling or publishing).
-
400SOCIAL_POST_MEDIA_TOO_MANYMore files than
media_max_items. -
400SOCIAL_POST_MEDIA_INVALIDA file is not in the store's Content Studio library or is not a photo or video;
details.positionsays which. -
503SOCIAL_POST_MEDIA_UNAVAILABLEThe library could not be reached; nothing was saved. Try again.
-
400SOCIAL_POST_SCHEDULE_REQUIREDactionisschedulewithoutscheduled_at. -
400SOCIAL_POST_SCHEDULE_PASTscheduled_atis not in the future. -
400SOCIAL_POST_SCHEDULE_TOO_FARscheduled_atis more thanschedule_max_daysahead. -
400SOCIAL_POST_CHANNEL_RULESThe post breaks a channel's rules;
details.issueslists each one as validate returns it. -
409SOCIAL_POST_NOT_EDITABLEThe post is publishing or published.
-
409SOCIAL_POST_VERSION_CONFLICTversionis not the post's current version. -
400STORE_API_BODY_PROPERTY_UNKNOWNThe body has a property this request does not accept. The message and
error.details.propertieslist the allowed and required properties (nestedfor each object or list of objects). -
400STORE_API_BODY_PROPERTY_INVALIDA body property has the wrong type (
error.details.expected_type). The message anderror.details.propertieslist the allowed and required properties.
Publish a social post now
Publish a draft, scheduled or failed post straight away.
Checks every channel's rules, then publishes the channels that have not published yet. A partly failed post retries only its failed channels.
Path parameters
| Name | Type | Description |
|---|---|---|
id
required
|
uuid |
Social post id. |
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Errors
-
400SOCIAL_POST_ID_INVALIDPost id is not a valid UUID.
-
404NOT_FOUNDPost does not exist in this store.
-
409SOCIAL_POST_NOT_EDITABLEThe post is publishing, published or cancelled.
-
400SOCIAL_POST_CHANNEL_RULESThe post breaks a channel's rules; see
details.issues.
Cancel a social post
Stop a scheduled post from publishing.
The post keeps its content with status cancelled; update it with action schedule to schedule it again.
Path parameters
| Name | Type | Description |
|---|---|---|
id
required
|
uuid |
Social post id. |
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Errors
-
400SOCIAL_POST_ID_INVALIDPost id is not a valid UUID.
-
404NOT_FOUNDPost does not exist in this store.
-
409SOCIAL_POST_NOT_CANCELLABLEThe post is not scheduled.
Delete a social post
Delete a post from Content Studio.
Deletes the post from Tringify. A post already published on Instagram or Facebook stays there. A post that is publishing cannot be deleted.
Path parameters
| Name | Type | Description |
|---|---|---|
id
required
|
uuid |
Social post id. |
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Errors
-
400SOCIAL_POST_ID_INVALIDPost id is not a valid UUID.
-
404NOT_FOUNDPost does not exist in this store.
-
409SOCIAL_POST_NOT_DELETABLEThe post is publishing.
Bulk cancel social posts
Cancel several scheduled posts.
Cancels every selected post that is still scheduled in one step and returns how many were cancelled; posts in another status are left as they are and counted in skipped_count. If an id is invalid, missing or belongs to another store, none are changed.
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Body parameters
| Name | Type | Description |
|---|---|---|
ids
required
|
array<uuid> |
Post ids, up to 100 ( |
Errors
-
400STORE_API_INVALID_REQUEST_BODYRequest body is not a JSON object.
-
400SOCIAL_POST_ID_INVALIDAn id in
idsis not a valid UUID. -
400SOCIAL_POST_BULK_NO_IDSNo ids were provided.
-
400SOCIAL_POST_BULK_TOO_MANYBatch exceeds
bulk_max_items. -
404NOT_FOUNDOne or more posts do not exist in this store.
-
400STORE_API_BODY_PROPERTY_UNKNOWNThe body has a property this request does not accept. The message and
error.details.propertieslist the allowed and required properties (nestedfor each object or list of objects). -
400STORE_API_BODY_PROPERTY_INVALIDA body property has the wrong type (
error.details.expected_type). The message anderror.details.propertieslist the allowed and required properties.
Bulk delete social posts
Delete several posts.
Deletes every selected post in one step; posts that are publishing are left as they are and counted in skipped_count. If an id is invalid, missing or belongs to another store, none are deleted.
Headers
| Name | Type | Description |
|---|---|---|
Authorization
required
|
string |
Bearer Store API token. |
Body parameters
| Name | Type | Description |
|---|---|---|
ids
required
|
array<uuid> |
Post ids, up to 100 ( |
Errors
-
400STORE_API_INVALID_REQUEST_BODYRequest body is not a JSON object.
-
400SOCIAL_POST_ID_INVALIDAn id in
idsis not a valid UUID. -
400SOCIAL_POST_BULK_NO_IDSNo ids were provided.
-
400SOCIAL_POST_BULK_TOO_MANYBatch exceeds
bulk_max_items. -
404NOT_FOUNDOne or more posts do not exist in this store.
-
400STORE_API_BODY_PROPERTY_UNKNOWNThe body has a property this request does not accept. The message and
error.details.propertieslist the allowed and required properties (nestedfor each object or list of objects). -
400STORE_API_BODY_PROPERTY_INVALIDA body property has the wrong type (
error.details.expected_type). The message anderror.details.propertieslist the allowed and required properties.
Fields#
Field |
Type |
Create |
Update |
Required |
Translatable |
|---|---|---|---|---|---|
|
textarea |
Yes |
Yes |
No |
|
|
id_list |
Yes |
Yes |
No |
|
|
select |
Yes |
Yes |
create, update |
No |
|
select |
No |
No |
No |
|
|
datetime |
Yes |
Yes |
No |
|
|
datetime |
No |
No |
No |
|
|
datetime |
No |
No |
No |
|
|
datetime |
No |
No |
No |
Webhook events#
Subscribe to these events to keep your integration in sync with social posts. Each event shows the required Store API scope and store permission, the available payload fields, and an example payload. Subscription setup is validated against those permissions; delivery is always restricted to the subscription's store.
Social post published
Fired when every channel of a Content Studio post has finished and at least one channel published it. data.social_post carries each channel's status, its external_id and permalink on Instagram or Facebook, and why a channel failed. A post that published on one channel and failed on another fires this and social_posts/failed.
Payload fields
| Field | Type | Description |
|---|---|---|
social_post |
object |
Always present |
social_post.id |
string |
Always present |
social_post.caption |
string |
Always present |
social_post.status |
string |
Always present |
social_post.media_file_ids |
array |
Always present |
social_post.scheduled_at |
string | null |
Selectable in the Payload builder |
social_post.published_at |
string | null |
Selectable in the Payload builder |
social_post.targets |
array |
Always present |
social_post.targets[*].channel |
string |
Always present |
social_post.targets[*].status |
string |
Always present |
social_post.targets[*].external_id |
string | null |
Selectable in the Payload builder |
social_post.targets[*].permalink |
string | null |
Selectable in the Payload builder |
social_post.targets[*].error_code |
string | null |
Selectable in the Payload builder |
social_post.targets[*].error_message |
string | null |
Selectable in the Payload builder |
social_post.targets[*].attempts |
integer |
Always present |
social_post.targets[*].published_at |
string | null |
Selectable in the Payload builder |
social_post.created_at |
string |
Always present |
social_post.updated_at |
string |
Always present |
Social post failed
Fired when a channel of a Content Studio post gave up publishing (after its retries, or at once when Meta refused it) and every channel has finished. data.social_post carries each channel's error_code and error_message.
Payload fields
| Field | Type | Description |
|---|---|---|
social_post |
object |
Always present |
social_post.id |
string |
Always present |
social_post.caption |
string |
Always present |
social_post.status |
string |
Always present |
social_post.media_file_ids |
array |
Always present |
social_post.scheduled_at |
string | null |
Selectable in the Payload builder |
social_post.published_at |
string | null |
Selectable in the Payload builder |
social_post.targets |
array |
Always present |
social_post.targets[*].channel |
string |
Always present |
social_post.targets[*].status |
string |
Always present |
social_post.targets[*].external_id |
string | null |
Selectable in the Payload builder |
social_post.targets[*].permalink |
string | null |
Selectable in the Payload builder |
social_post.targets[*].error_code |
string | null |
Selectable in the Payload builder |
social_post.targets[*].error_message |
string | null |
Selectable in the Payload builder |
social_post.targets[*].attempts |
integer |
Always present |
social_post.targets[*].published_at |
string | null |
Selectable in the Payload builder |
social_post.created_at |
string |
Always present |
social_post.updated_at |
string |
Always present |
Content Studio post limits
Fetch post limits and each channel's rules.
Returns list and bulk limits,
caption_max_length,media_max_items,schedule_max_days(how far ahead a post can be scheduled),range_max_days(the longestfrom–towindow a list can ask for),max_attemptsandrules: Meta's current limits for Instagram and Facebook that every post is checked against before it is scheduled.status_optionsandchannel_optionslist eachvaluewith its English displaylabel.Headers
AuthorizationrequiredstringBearer Store API token.