Social

Publish or schedule a post

Posts a video or image to the given connected accounts now, or at scheduled_at. Creates one post per account. If some accounts fail after others went out, the call still succeeds and the failed ones come back with status failed and an error, so retrying never posts twice. media_url can be any public HTTPS link to the file, for example a Rendley export URL: posting now hands the link to Post for Me as is; a scheduled post copies the file first, so the link may expire before the scheduled time. Requires a plan with social publishing.

post/social/posts

Request

  • Base URL
    https://api.rendley.com/v1
  • Auth
    API key in header Authorization

Request body

account_idsstring[] required

Ids from GET /social/accounts.

captionstring

Checked against each target platform's limit, e.g. 280 characters on X.

captionsobject

Per-platform caption keyed by platform, e.g. {"x": "..."}; overrides caption for that platform.

media_urlstring required

Public HTTPS link to an mp4/mov video or a jpeg/png/webp/gif image, e.g. an export URL.

project_idstring

The Rendley project the video comes from, shown with the post in the app.

scheduled_atstring

RFC 3339 time to publish at; omit to publish now.

thumbnail_urlstring

Preview image the app shows with the post; not sent to the platforms.

workspace_idstring required

Response

OK

metaunknown

Changes

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