Skip to main content
POST
Draft a scheduled social post

Authorizations

Authorization
string
header
required

A Motion API key. Access is limited to its stored organization, workspace, scopes and the creator’s current permissions.

Scopes

motion:social:write

Draft, submit, approve and cancel posts within current app permissions.

Body

application/json
connectionId
string<uuid>
required
scheduledAt
string<date-time>
required
sourceChatId
string<uuid>
required

Source Motion project chat ID. Required for agent-created posts; current workspace sharing and permissions apply.

caption
string
mediaUrls
string[]
Maximum array length: 10
thumbnailUrl
string | null
youtubeTitle
string | null
youtubeDescription
string | null

Response

Success

id
string<uuid>
required

Identifier of this resource. Use it when reading or updating the same resource.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
connectionId
string<uuid>
required

Enabled social destination UUID from list_social_accounts in the connected workspace.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
revision
integer
required

Post edit version. Pass it when editing, submitting, approving or cancelling this post; a stale version returns a conflict.

Required range: x <= 9007199254740991
status
enum<string>
required

Current state. The enum lists the values this resource can return.

Available options:
draft,
in_review,
scheduled,
processing,
posted,
failed,
cancelled
sourceChatId
string | null

Accessible source project chat UUID in the selected workspace. Required for agent-created social posts.

caption
string | null

Post copy within the destination’s platform limits; review before scheduling publication.

scheduledAt
string<date-time> | null

Future publication time as an ISO timestamp including its UTC offset.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
approvedBy
string | null

Member UUID that approved publication, or null before approval.

postUrl
string | null

Provider URL of the published post, or null before verified publication.

error
string | null

Actionable error text or sanitized failure code, or null when no error is present.

hasMedia
boolean

Whether this post includes uploaded image or video media.

hasThumbnail
boolean

Whether this post includes an uploaded video thumbnail.

publicationLocked
boolean

Whether provider submission has begun, so editing or cancellation may be restricted.

{key}
any