Create a post

Creates one post per channel. Use the schedule field to control publishing: "draft" (default), "next_slot", "now", or an ISO 8601 datetime — everything except "draft" also requires the posts:publish scope. Send an Idempotency-Key header to make retries safe.

Authorization

api-key

AuthorizationBearer <token>

Workspace API key (nim_live_...)

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

channelIds*array<string>

Channel ids to publish to (one post is created per channel). Get ids from GET /v1/channels.

content?string

Post text/caption

title?string

Title (used by YouTube and Pinterest)

contentType?string

Content type. Multiple media on a POST become a carousel.

Default"POST"

Value in

"POST"
"REEL"
"STORY"
"VIDEO"

mediaIds?array<string>

Media asset ids in display order (upload via POST /v1/media first)

schedule?string

When to publish: "draft" (default, create only), "next_slot" (next free posting-schedule slot per channel), "now" (publish immediately), or an ISO 8601 datetime. Anything except "draft" requires the posts:publish scope.

Response Body

`application/json`

curl -X POST "https://example.com/v1/posts" \  -H "Content-Type: application/json" \  -d '{    "channelIds": [      "123e4567-e89b-12d3-a456-426614174000"    ]  }'

[  {    "id": "123e4567-e89b-12d3-a456-426614174000",    "channelId": "123e4567-e89b-12d3-a456-426614174000",    "content": "Launching something new today 🚀",    "title": null,    "contentType": "POST",    "status": "SCHEDULED",    "scheduledAt": "2026-08-01T09:00:00.000Z",    "publishedAt": null,    "createdAt": "2026-07-05T10:00:00.000Z",    "mediaIds": [      "string"    ]  }]

Create a post

Authorization

Request Body

Response Body

201application/json

`application/json`