POSTposts:write

Create a post

Create a post draft or scheduled post using the organization context resolved from the API key.

Request

POST /api/posts

Authorization: Bearer <api_key>

Representative request body

{
  "content": "Launch post copy",
  "scheduledAt": "2026-04-11T09:00:00.000Z",
  "socialAccountIds": [
    "replace_with_connected_account_id"
  ],
  "timezone": "UTC"
}

Examples

curl -X POST "https://api.creagency.ai/api/posts" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Launch post copy",
    "scheduledAt": "2026-04-11T09:00:00.000Z",
    "socialAccountIds": [
      "replace_with_connected_account_id"
    ],
    "timezone": "UTC"
  }'

Responses

200

Post created

400

Validation error

401

Missing, invalid, expired, or revoked API key

403

Missing posts:write scope or plan upgrade required