Posts

Create a post

Requires posts:write. Creation defaults to a draft. Set is_draft to false and provide an offset-aware scheduled_at to schedule. Immediate publishing also requires publish:now, workspace opt-in, is_draft: false, and publish_now: true.

post/posts

Request

  • Base URL: https://api.post-quest.com/v1
  • URL: https://api.post-quest.com/v1/posts
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Unique visible-ASCII key, 1–255 characters. Retained for 24 hours.

Request body

captionstring required
social_account_idsstring[]
platform_captionsobject

Platform or platform:<social account id> target keys mapped to custom captions.

content_pillarstring nullable
content_pillar_idstring uuid nullable
media_idsstring[]
scheduled_atstring date-time nullable

Must contain Z or an explicit UTC offset and be in the future.

publish_nowboolean
account_configurationsAccountConfigurations

Keys use pinterest:{social_account_id}.

is_draftboolean

Set false before scheduling or publishing from this operation.

Response

Post created.

Changes

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