Posts

Create a post

A draft (the default), a post scheduled at scheduledAt, or one queued at its profile's next free posting time (queue: true), to one or more accounts of one profile. Each target is an account and a format, with its own text, files, options and first comment when it needs them. What a network would refuse is refused now with the reason, such as a first comment where the network takes none, or a story's own text on Instagram or Facebook; what only stops a post from going out, such as TikTok's choices on a draft, waits until it is scheduled. Check a post without creating it lists every problem at once. To publish now, create it, then Publish a post now.

post/posts

Request

  • Base URL
    https://api.rizamo.com/v1
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

1 to 255 printable characters, new for each request (a UUID); the body up to 1 MB. For 24 hours a repeat with the same key, path and body gets the first answer, with Idempotent-Replayed: true, instead of running again; 5xx, 409 and 429 answers are not kept. Errors, Retries, has the rest.

Request body

profileIdstring required

The profile (prof_) the post is for: the brand whose accounts it goes to.

textstring required

The caption, on every target that has no text of its own. A draft may have none; to go out, each target needs a text or a file (or for Facebook a link).

mediaIdsstring[]

Its files (med_, from Add media or an upload request), in order: on every target that has none of its own.

scheduledAtstring date-time nullable

When it goes out. With Z or an offset (2026-11-03T09:00:00+01:00) it is exact. Without one (2026-11-03T09:00) it is a local time in timeZone, or in the profile's time zone. Answers are in UTC.

timeZonestring

Reads a scheduledAt without an offset; the profile's time zone when left out.

fieldsobject

Custom field values by key (List custom fields), such as { "campaign": "Winter menu" }.

status'draft' | 'scheduled'

draft (the default) never publishes. scheduled needs a future scheduledAt, or queue: true.

queueboolean

Schedules it at the next time of its profile's queue (Get a profile's queue) when none of its accounts has a post then and none would pass its network's daily cap, up to 90 days ahead. Instead of scheduledAt, never with it; status becomes scheduled, and the answer's scheduledAt is the time it took. A queue with no times answers queue_empty, one with none free queue_full.

Example request

{
  "mediaIds": [
    "med_01jbx3k9q8f7t2r5m4n6p8s0vw"
  ],
  "scheduledAt": "2026-11-03T09:00"
}

Response

OK

idstring required
profileIdstring required
status'draft' | 'scheduled' | 'published' | 'partially_published' | 'failed' required

partially_published: some targets went out and others failed, or a target's chain stopped partway (its chainResults say where); each target has its own status.

textstring required
scheduledAtstring date-time nullable required
queuedboolean required

It took scheduledAt from its profile's queue (queue: true): the time stays as it was given when the queue's times change.

publishedAtstring date-time nullable required
createdAtstring date-time required
updatedAtstring date-time required
fieldsobject required
deletedAtstring date-time nullable required

Restore a deleted post within 30 days. After that it goes for good, unless a target is still live on its network.

sharedUntilstring date-time nullable required

When its preview links stop working, while it is shared (Share a preview of a post). Null when it is not.

Changes

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