Nimply Developers
API ReferencePosts

Create posts in bulk

POST
/v1/posts/bulk

Creates up to 50 posts in one request. Items are processed in order; a failing item does not abort the batch — check each result. Scheduling rules and scopes are identical to createPost. Send an Idempotency-Key header to make retries safe.

AuthorizationBearer <token>

Workspace API key (nim_live_...)

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/posts/bulk" \  -H "Content-Type: application/json" \  -d '{    "posts": [      {        "channelIds": [          "123e4567-e89b-12d3-a456-426614174000"        ]      }    ]  }'
[  {    "index": 0,    "success": true,    "posts": [      {        "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"        ]      }    ],    "error": "string"  }]