Skip to main content
POST
Schedule a Social Selling draft

Authorizations

x-api-key
string
header
required

Path Parameters

draftId
integer
required

Draft id (draftId).

Body

application/json
version
integer
required

The version you previewed and approve. An edited draft answers 409 VERSION_CONFLICT.

scheduledAt
string<date-time>

ISO 8601 instant with offset. Give exactly one of scheduledAt, localDateTime + timezone, publishNow.

Example:

"2026-11-03T08:30:00Z"

localDateTime
string

Wall-clock time in timezone, without offset. A time skipped by daylight saving answers 400; a repeated one means its first occurrence.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?$
Example:

"2026-11-03T09:30"

timezone
string

IANA zone.

Required string length: 1 - 64
Example:

"Europe/Madrid"

publishNow
boolean

Publish about a minute from now.

reactionsAmount
integer

Reactions from the workspace’s identity pool once live. Default 0.

Required range: 0 <= x <= 500
reactionTypes
enum<string>[]
Minimum array length: 1
Available options:
LIKE,
PRAISE,
EMPATHY,
INTEREST,
APPRECIATION,
ENTERTAINMENT
idempotencyKey
string

Any unique string per intended schedule. A retry with the same key returns the first answer (replayed: true) instead of scheduling twice. The Idempotency-Key header works too.

Required string length: 1 - 200

Response

Scheduled (or the replayed earlier answer)

status
enum<string>
required
Available options:
success
message
string
required
data
object
required