Content Studio posts

Schedule social posts to Instagram and Facebook, publish them now, and follow what happened on each channel.

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#

Content Studio post limits

GET read_marketing

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 longest from–to window a list can ask for), max_attempts and rules: Meta's current limits for Instagram and Facebook that every post is checked against before it is scheduled. status_options and channel_options list each value with its English display label.

Headers

Name Type Description
Authorization required string

Bearer Store API token.

List Content Studio channels

GET read_marketing

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

GET read_marketing

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, at most 62 days.

Example: 2026-12-01T00:00:00-05:00
to datetime

End of the range (exclusive).

Example: 2027-01-01T00:00:00-05:00
status string

Only posts with this status.

Allowed values
draftscheduledpublishingpublishedpartially_failedfailedcancelled
Example: scheduled
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 (list_max_limit from the limits). Default 50.

Example: 50

Headers

Name Type Description
Authorization required string

Bearer Store API token.

Errors

  • 400 VALIDATION_LIST_INVALID_LIMIT

    Limit is not between 1 and list_max_limit.

  • 400 INVALID_INPUT

    cursor is invalid or stale, or from/to is not an RFC 3339 time.

  • 400 SOCIAL_POST_RANGE_INVALID

    to is not after from, only one was sent, or the range is longer than range_max_days.

  • 400 SOCIAL_POST_STATUS_INVALID

    Status is not one of status_options.

  • 400 STORE_API_QUERY_PARAMETER_UNKNOWN

    The query string has a parameter this request does not accept. The message and error.details.allowed_parameters list the ones it does.

Get a social post

GET read_marketing

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.

Example: 5ff7d4ea-3250-4a4d-9d26-07f64d917d31

Headers

Name Type Description
Authorization required string

Bearer Store API token.

Errors

  • 400 SOCIAL_POST_ID_INVALID

    Post id is not a valid UUID.

  • 404 NOT_FOUND

    Post does not exist in this store.

Check a social post

POST read_marketing

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.

Example: New drop this Friday. #coffee
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.

Example: ["3a9d1f64-2c7b-4e85-9f10-6b4c8e2d7a53"]
channels required array<string>

instagram and/or facebook_page.

Example: ["instagram","facebook_page"]
scheduled_at datetime

RFC 3339 time it would publish at; checks Instagram's 24-hour limit around it.

Example: 2026-12-04T10:00:00-05:00

Errors

  • 400 STORE_API_INVALID_REQUEST_BODY

    Request body is not a JSON object.

  • 400 SOCIAL_POST_CAPTION_TOO_LONG

    Caption is longer than caption_max_length.

  • 400 SOCIAL_POST_CHANNELS_REQUIRED

    No channel was chosen.

  • 400 SOCIAL_POST_CHANNEL_INVALID

    A channel is not instagram or facebook_page.

  • 409 SOCIAL_POST_CHANNEL_NOT_CONNECTED

    A chosen channel is not connected (only when scheduling or publishing).

  • 400 SOCIAL_POST_MEDIA_TOO_MANY

    More files than media_max_items.

  • 400 SOCIAL_POST_MEDIA_INVALID

    A file is not in the store's Content Studio library or is not a photo or video; details.position says which.

  • 503 SOCIAL_POST_MEDIA_UNAVAILABLE

    The library could not be reached; nothing was saved. Try again.

  • 400 SOCIAL_POST_SCHEDULE_REQUIRED

    action is schedule without scheduled_at.

  • 400 SOCIAL_POST_SCHEDULE_PAST

    scheduled_at is not in the future.

  • 400 SOCIAL_POST_SCHEDULE_TOO_FAR

    scheduled_at is more than schedule_max_days ahead.

  • 400 SOCIAL_POST_CHANNEL_RULES

    The post breaks a channel's rules; details.issues lists each one as validate returns it.

  • 400 STORE_API_BODY_PROPERTY_UNKNOWN

    The body has a property this request does not accept. The message and error.details.properties list the allowed and required properties (nested for each object or list of objects).

  • 400 STORE_API_BODY_PROPERTY_INVALID

    A body property has the wrong type (error.details.expected_type). The message and error.details.properties list the allowed and required properties.

Create a social post

POST write_marketing

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.

Example: New drop this Friday. #coffee
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.

Example: ["3a9d1f64-2c7b-4e85-9f10-6b4c8e2d7a53"]
channels required array<string>

instagram and/or facebook_page.

Example: ["instagram","facebook_page"]
action required string

draft, schedule or publish_now.

Allowed values
draftschedulepublish_now
Example: schedule
scheduled_at datetime

RFC 3339 time to publish at; required for schedule.

Example: 2026-12-04T10:00:00-05:00

Errors

  • 400 STORE_API_INVALID_REQUEST_BODY

    Request body is not a JSON object.

  • 400 SOCIAL_POST_CAPTION_TOO_LONG

    Caption is longer than caption_max_length.

  • 400 SOCIAL_POST_CHANNELS_REQUIRED

    No channel was chosen.

  • 400 SOCIAL_POST_CHANNEL_INVALID

    A channel is not instagram or facebook_page.

  • 409 SOCIAL_POST_CHANNEL_NOT_CONNECTED

    A chosen channel is not connected (only when scheduling or publishing).

  • 400 SOCIAL_POST_MEDIA_TOO_MANY

    More files than media_max_items.

  • 400 SOCIAL_POST_MEDIA_INVALID

    A file is not in the store's Content Studio library or is not a photo or video; details.position says which.

  • 503 SOCIAL_POST_MEDIA_UNAVAILABLE

    The library could not be reached; nothing was saved. Try again.

  • 400 SOCIAL_POST_SCHEDULE_REQUIRED

    action is schedule without scheduled_at.

  • 400 SOCIAL_POST_SCHEDULE_PAST

    scheduled_at is not in the future.

  • 400 SOCIAL_POST_SCHEDULE_TOO_FAR

    scheduled_at is more than schedule_max_days ahead.

  • 400 SOCIAL_POST_CHANNEL_RULES

    The post breaks a channel's rules; details.issues lists each one as validate returns it.

  • 400 STORE_API_BODY_PROPERTY_UNKNOWN

    The body has a property this request does not accept. The message and error.details.properties list the allowed and required properties (nested for each object or list of objects).

  • 400 STORE_API_BODY_PROPERTY_INVALID

    A body property has the wrong type (error.details.expected_type). The message and error.details.properties list the allowed and required properties.

Update a social post

PUT write_marketing

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.

Example: 5ff7d4ea-3250-4a4d-9d26-07f64d917d31

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.

Example: New drop this Friday. #coffee
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.

Example: ["3a9d1f64-2c7b-4e85-9f10-6b4c8e2d7a53"]
channels required array<string>

instagram and/or facebook_page.

Example: ["instagram","facebook_page"]
action required string

draft, schedule or publish_now.

Allowed values
draftschedulepublish_now
Example: schedule
scheduled_at datetime

RFC 3339 time to publish at; required for schedule.

Example: 2026-12-04T10:00:00-05:00
version required integer

The post's version as you read it.

Example: 3

Errors

  • 400 SOCIAL_POST_ID_INVALID

    Post id is not a valid UUID.

  • 404 NOT_FOUND

    Post does not exist in this store.

  • 400 STORE_API_INVALID_REQUEST_BODY

    Request body is not a JSON object.

  • 400 SOCIAL_POST_CAPTION_TOO_LONG

    Caption is longer than caption_max_length.

  • 400 SOCIAL_POST_CHANNELS_REQUIRED

    No channel was chosen.

  • 400 SOCIAL_POST_CHANNEL_INVALID

    A channel is not instagram or facebook_page.

  • 409 SOCIAL_POST_CHANNEL_NOT_CONNECTED

    A chosen channel is not connected (only when scheduling or publishing).

  • 400 SOCIAL_POST_MEDIA_TOO_MANY

    More files than media_max_items.

  • 400 SOCIAL_POST_MEDIA_INVALID

    A file is not in the store's Content Studio library or is not a photo or video; details.position says which.

  • 503 SOCIAL_POST_MEDIA_UNAVAILABLE

    The library could not be reached; nothing was saved. Try again.

  • 400 SOCIAL_POST_SCHEDULE_REQUIRED

    action is schedule without scheduled_at.

  • 400 SOCIAL_POST_SCHEDULE_PAST

    scheduled_at is not in the future.

  • 400 SOCIAL_POST_SCHEDULE_TOO_FAR

    scheduled_at is more than schedule_max_days ahead.

  • 400 SOCIAL_POST_CHANNEL_RULES

    The post breaks a channel's rules; details.issues lists each one as validate returns it.

  • 409 SOCIAL_POST_NOT_EDITABLE

    The post is publishing or published.

  • 409 SOCIAL_POST_VERSION_CONFLICT

    version is not the post's current version.

  • 400 STORE_API_BODY_PROPERTY_UNKNOWN

    The body has a property this request does not accept. The message and error.details.properties list the allowed and required properties (nested for each object or list of objects).

  • 400 STORE_API_BODY_PROPERTY_INVALID

    A body property has the wrong type (error.details.expected_type). The message and error.details.properties list the allowed and required properties.

Publish a social post now

POST write_marketing

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.

Example: 5ff7d4ea-3250-4a4d-9d26-07f64d917d31

Headers

Name Type Description
Authorization required string

Bearer Store API token.

Errors

  • 400 SOCIAL_POST_ID_INVALID

    Post id is not a valid UUID.

  • 404 NOT_FOUND

    Post does not exist in this store.

  • 409 SOCIAL_POST_NOT_EDITABLE

    The post is publishing, published or cancelled.

  • 400 SOCIAL_POST_CHANNEL_RULES

    The post breaks a channel's rules; see details.issues.

Cancel a social post

POST write_marketing

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.

Example: 5ff7d4ea-3250-4a4d-9d26-07f64d917d31

Headers

Name Type Description
Authorization required string

Bearer Store API token.

Errors

  • 400 SOCIAL_POST_ID_INVALID

    Post id is not a valid UUID.

  • 404 NOT_FOUND

    Post does not exist in this store.

  • 409 SOCIAL_POST_NOT_CANCELLABLE

    The post is not scheduled.

Delete a social post

DELETE write_marketing

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.

Example: 5ff7d4ea-3250-4a4d-9d26-07f64d917d31

Headers

Name Type Description
Authorization required string

Bearer Store API token.

Errors

  • 400 SOCIAL_POST_ID_INVALID

    Post id is not a valid UUID.

  • 404 NOT_FOUND

    Post does not exist in this store.

  • 409 SOCIAL_POST_NOT_DELETABLE

    The post is publishing.

Bulk cancel social posts

POST write_marketing

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 (bulk_max_items from the limits).

Example: ["7c2e5a91-4b3d-4f6e-8a1c-2d9b0e7f6a35"]

Errors

  • 400 STORE_API_INVALID_REQUEST_BODY

    Request body is not a JSON object.

  • 400 SOCIAL_POST_ID_INVALID

    An id in ids is not a valid UUID.

  • 400 SOCIAL_POST_BULK_NO_IDS

    No ids were provided.

  • 400 SOCIAL_POST_BULK_TOO_MANY

    Batch exceeds bulk_max_items.

  • 404 NOT_FOUND

    One or more posts do not exist in this store.

  • 400 STORE_API_BODY_PROPERTY_UNKNOWN

    The body has a property this request does not accept. The message and error.details.properties list the allowed and required properties (nested for each object or list of objects).

  • 400 STORE_API_BODY_PROPERTY_INVALID

    A body property has the wrong type (error.details.expected_type). The message and error.details.properties list the allowed and required properties.

Bulk delete social posts

POST write_marketing

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 (bulk_max_items from the limits).

Example: ["7c2e5a91-4b3d-4f6e-8a1c-2d9b0e7f6a35"]

Errors

  • 400 STORE_API_INVALID_REQUEST_BODY

    Request body is not a JSON object.

  • 400 SOCIAL_POST_ID_INVALID

    An id in ids is not a valid UUID.

  • 400 SOCIAL_POST_BULK_NO_IDS

    No ids were provided.

  • 400 SOCIAL_POST_BULK_TOO_MANY

    Batch exceeds bulk_max_items.

  • 404 NOT_FOUND

    One or more posts do not exist in this store.

  • 400 STORE_API_BODY_PROPERTY_UNKNOWN

    The body has a property this request does not accept. The message and error.details.properties list the allowed and required properties (nested for each object or list of objects).

  • 400 STORE_API_BODY_PROPERTY_INVALID

    A body property has the wrong type (error.details.expected_type). The message and error.details.properties list the allowed and required properties.

Fields#

Field

Type

Create

Update

Required

Translatable

caption

textarea

Yes

Yes

No

media_file_ids

id_list

Yes

Yes

No

channels

select

Yes

Yes

create, update

No

status

select

No

No

No

scheduled_at

datetime

Yes

Yes

No

published_at

datetime

No

No

No

created_at

datetime

No

No

No

updated_at

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

EVENT social_posts/published App scope: read_marketing Staff permission: marketing:read

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

EVENT social_posts/failed App scope: read_marketing Staff permission: marketing:read

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