Publishing Runs and Posts

Create run

Creates a scheduled or draft run from a validated schedule.

Note: Use idempotencyKey for generated schedules and retry-safe clients.

Note: The route preflights connected accounts and plan entitlements before creating posts.

post/v1/posts/apply

Request

  • Base URL: https://getsocialclaw.com
  • URL: https://getsocialclaw.com/v1/posts/apply
  • Auth: HTTP bearer

Request body

timezonestring

IANA timezone. Defaults to UTC.

mode'scheduled' | 'draft'

scheduled creates runnable posts; draft creates an editable draft run.

idempotencyKeystring nullable

Optional idempotency key. Also accepted as idempotency_key.

scheduleobject

Optional wrapper. Routes accept either the envelope directly or { schedule: envelope }.

Response

Successful response.

okunknown required
duplicateboolean

True when idempotency reused an existing run.

modestring nullable

draft or scheduled.

sourceModelstring nullable

posts_v1 or campaigns_v2.

summaryobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.