Socials

Create a post

Creates a draft post, or publishes/schedules it immediately when publish_now or scheduled_at is set.

post/socials/posts

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/socials/posts
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

contentstring required
titlestring nullable
platformsstring[] required
platform_dataobject

Per-platform overrides keyed by platform name. For Pinterest, pinterest.board_id names the target board (list them with GET /socials/accounts/{id}/boards).

media_urlsstring[]

Public media URLs uploaded on publish

upload_idsstring[]

Previously uploaded media IDs

youtube_type'SHORT' | 'VIDEO'
publish_nowboolean

Publish immediately instead of saving a draft

scheduled_atstring date-time
account_idsstring[]

Target account IDs (defaults to all matching platforms)

Response

Post created

objectstring required
idstring required
titlestring nullable required
contentstring required
platformsobject required
platform_dataobject required
status'draft' | 'publishing' | 'scheduled' | 'posted' | 'failed' | 'disconnected' required
scheduled_atstring date-time nullable required
posted_atstring date-time nullable required
errorstring nullable required
analyticsobject required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.