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 scheduledAt to publish immediately.

Request body

postsany[]required

Minimum items:1

accountIdstringrequired

Minimum string length:1

platform = "YOUTUBE"

scheduledAtstring (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

aiGeneratedbooleanoptional

platform = "FACEBOOK"

scheduledAtstring (date-time)optional

Format:ISO 8601 date-time

platform"FACEBOOK"required

configobjectrequired

captionstringrequired

assetsIdsstring[]required

platformCustomDataunionrequired

kind = "POST"

kind"POST"required

aiGeneratedbooleanoptional

kind = "REEL"

kind"REEL"required

aiGeneratedbooleanoptional

kind = "STORY"

kind"STORY"required

aiGeneratedbooleanoptional

platform = "INSTAGRAM"

scheduledAtstring (date-time)optional

Format:ISO 8601 date-time

platform"INSTAGRAM"required

configobjectrequired

captionstringrequired

assetsIdsstring[]required

platformCustomDataunionrequired

kind = "POST"

kind"POST"required

aiGeneratedbooleanoptional

collaboratorsstring[]optional

Maximum items:3

kind = "REEL"

kind"REEL"required

aiGeneratedbooleanoptional

collaboratorsstring[]optional

Maximum items:3

shareToFeedbooleanoptional

kind = "STORY"

kind"STORY"required

aiGeneratedbooleanoptional

platform = "X"

scheduledAtstring (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"

scheduledAtstring (date-time)optional

Format:ISO 8601 date-time

platform"TIKTOK"required

configobjectrequired

captionstringrequired

Maximum string length:2200

assetsIdsstring[]required

Minimum items:1

Maximum items:35

platformCustomDataobjectrequired

privacyLevelunionrequired

variant 1

variant 2

allowCommentbooleanoptional

allowDuetbooleanoptional

allowStitchbooleanoptional

contentDisclosurebooleanoptional

yourBrandbooleanoptional

brandedContentbooleanoptional

aiGeneratedbooleanoptional

platform = "THREADS"

scheduledAtstring (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"

scheduledAtstring (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"

scheduledAtstring (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

platform = "BLUESKY"

scheduledAtstring (date-time)optional

Format:ISO 8601 date-time

platform"BLUESKY"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:300

assetsIdsstring[]required

Maximum items:4

platformCustomDatanullrequired

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

postIdstringrequired

Minimum string length:1

dataunionrequired

platform = "YOUTUBE"

scheduledAtstring (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

aiGeneratedbooleanoptional

platform = "FACEBOOK"

scheduledAtstring (date-time)optional

Format:ISO 8601 date-time

platform"FACEBOOK"required

configobjectrequired

captionstringrequired

assetsIdsstring[]required

platformCustomDataunionrequired

kind = "POST"

kind"POST"required

aiGeneratedbooleanoptional

kind = "REEL"

kind"REEL"required

aiGeneratedbooleanoptional

kind = "STORY"

kind"STORY"required

aiGeneratedbooleanoptional

platform = "INSTAGRAM"

scheduledAtstring (date-time)optional

Format:ISO 8601 date-time

platform"INSTAGRAM"required

configobjectrequired

captionstringrequired

assetsIdsstring[]required

platformCustomDataunionrequired

kind = "POST"

kind"POST"required

aiGeneratedbooleanoptional

collaboratorsstring[]optional

Maximum items:3

kind = "REEL"

kind"REEL"required

aiGeneratedbooleanoptional

collaboratorsstring[]optional

Maximum items:3

shareToFeedbooleanoptional

kind = "STORY"

kind"STORY"required

aiGeneratedbooleanoptional

platform = "X"

scheduledAtstring (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"

scheduledAtstring (date-time)optional

Format:ISO 8601 date-time

platform"TIKTOK"required

configobjectrequired

captionstringrequired

Maximum string length:2200

assetsIdsstring[]required

Minimum items:1

Maximum items:35

platformCustomDataobjectrequired

privacyLevelunionrequired

variant 1

variant 2

allowCommentbooleanoptional

allowDuetbooleanoptional

allowStitchbooleanoptional

contentDisclosurebooleanoptional

yourBrandbooleanoptional

brandedContentbooleanoptional

aiGeneratedbooleanoptional

platform = "THREADS"

scheduledAtstring (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"

scheduledAtstring (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"

scheduledAtstring (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

platform = "BLUESKY"

scheduledAtstring (date-time)optional

Format:ISO 8601 date-time

platform"BLUESKY"required

configobjectrequired

captionstringrequired

Minimum string length:1

Maximum string length:300

assetsIdsstring[]required

Maximum items:4

platformCustomDatanullrequired

Delete a post

POST/api/posts/delete

Permanently deletes a post.

Request body

postIdstringrequired

Minimum string length:1

Media Platform publishing