API Reference

Posts

Create, list, edit, and delete posts across every connected platform.

Create posts

POST/api/create

Publishes or schedules one or more posts in a single request. Each post targets a connected account and carries a platform-specific config — omit scheduled_at to publish immediately.

Request body

postsany[]required

Minimum items:1

account_idstringrequired

Minimum string length:1

platform = "YOUTUBE"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"YOUTUBE"required

configobjectrequired

captionstringrequired

Maximum string length:5000

assetsIdsstring[]required

Minimum items:1

Maximum items:1

platformCustomDataobjectrequired

titlestringrequired

Minimum string length:1

Maximum string length:100

tagsstring[]required

categoryenumrequired

Available options:2Autos & Vehicles,23Comedy,27Education,24Entertainment,1Film & Animation,20Gaming,26Howto & Style,10Music,25News & Politics,29Nonprofits & Activism,22People & Blogs,15Pets & Animals,28Science & Technology,17Sports,19Travel & Events

visibilityenumrequired

Available options:public,unlisted,private

licenseenumrequired

Available options:youtubeStandard Youtube License,creativeCommonCreative Commons Attribution

madeForKidsbooleanrequired

notifySubscribersbooleanrequired

allowEmbeddingbooleanrequired

platform = "FACEBOOK"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"FACEBOOK"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:2200

assetsIdsstring[]required

platformCustomDataobjectrequired

kindenumrequired

Available options:POST,REEL,STORY

platform = "INSTAGRAM"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"INSTAGRAM"required

configobjectrequired

captionstringrequired

Maximum string length:2200

assetsIdsstring[]required

platformCustomDataobjectrequired

kindenumrequired

Available options:POST,REEL,STORY

platform = "X"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"X"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:280

assetsIdsstring[]required

platformCustomDatanullrequired

platform = "TIKTOK"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"TIKTOK"required

configobjectrequired

captionstringrequired

Maximum string length:2200

assetsIdsstring[]required

Minimum items:1

Maximum items:1

platformCustomDataobjectrequired

privacyLevelenumrequired

Available options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDS,FOLLOWER_OF_CREATOR,SELF_ONLY

disableCommentbooleanoptional

disableDuetbooleanoptional

disableStitchbooleanoptional

platform = "THREADS"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"THREADS"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:500

assetsIdsstring[]required

platformCustomDatanullrequired

platform = "LINKEDIN"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"LINKEDIN"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:3000

assetsIdsstring[]required

platformCustomDatanullrequired

platform = "PINTEREST"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"PINTEREST"required

configobjectrequired

captionstringrequired

Maximum string length:800

assetsIdsstring[]required

Minimum items:1

platformCustomDataobjectrequired

boardIdstringrequired

Minimum string length:1

titleunionoptional

variant 1

variant 2

linkunionoptional

variant 1

variant 2

List posts

GET/api/posts

Returns the authenticated user's posts with their caption, status, platform data, and timestamps.

Edit a post

POST/api/posts/edit

Replaces the content of a draft or scheduled post. The data payload has the same shape as a post in the create endpoint.

Request body

post_idstringrequired

Minimum string length:1

dataunionrequired

platform = "YOUTUBE"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"YOUTUBE"required

configobjectrequired

captionstringrequired

Maximum string length:5000

assetsIdsstring[]required

Minimum items:1

Maximum items:1

platformCustomDataobjectrequired

titlestringrequired

Minimum string length:1

Maximum string length:100

tagsstring[]required

categoryenumrequired

visibilityenumrequired

Available options:public,unlisted,private

licenseenumrequired

Available options:youtubeStandard Youtube License,creativeCommonCreative Commons Attribution

madeForKidsbooleanrequired

notifySubscribersbooleanrequired

allowEmbeddingbooleanrequired

platform = "FACEBOOK"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"FACEBOOK"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:2200

assetsIdsstring[]required

platformCustomDataobjectrequired

kindenumrequired

Available options:POST,REEL,STORY

platform = "INSTAGRAM"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"INSTAGRAM"required

configobjectrequired

captionstringrequired

Maximum string length:2200

assetsIdsstring[]required

platformCustomDataobjectrequired

kindenumrequired

Available options:POST,REEL,STORY

platform = "X"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"X"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:280

assetsIdsstring[]required

platformCustomDatanullrequired

platform = "TIKTOK"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"TIKTOK"required

configobjectrequired

captionstringrequired

Maximum string length:2200

assetsIdsstring[]required

Minimum items:1

Maximum items:1

platformCustomDataobjectrequired

privacyLevelenumrequired

Available options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDS,FOLLOWER_OF_CREATOR,SELF_ONLY

disableCommentbooleanoptional

disableDuetbooleanoptional

disableStitchbooleanoptional

platform = "THREADS"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"THREADS"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:500

assetsIdsstring[]required

platformCustomDatanullrequired

platform = "LINKEDIN"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"LINKEDIN"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:3000

assetsIdsstring[]required

platformCustomDatanullrequired

platform = "PINTEREST"

scheduled_atstring (date-time)optional

Format:ISO 8601 date-time

platform"PINTEREST"required

configobjectrequired

captionstringrequired

Maximum string length:800

assetsIdsstring[]required

Minimum items:1

platformCustomDataobjectrequired

boardIdstringrequired

Minimum string length:1

titleunionoptional

variant 1

variant 2

linkunionoptional

variant 1

variant 2

Delete a post

POST/api/posts/delete

Permanently deletes a post.

Request body

post_idstringrequired

Minimum string length:1

Media Platform publishing