Posts

Create and schedule a post

Creates a post group and schedules it. scheduledAt is required and must be a future ISO 8601 datetime. timezone only affects recurrence.

post/api/posts/schedule

Request

  • Base URL: https://api-app.postnext.io
  • URL: https://api-app.postnext.io/api/posts/schedule
  • Auth: API key in header x-api-key

Request body

providersobject required

Map keyed by provider name (for example twitter) or provider:channelHandle for multi-account posting.

titlestring
descriptionstring
imageUrlstring uri
tagsstring[]
assigneeIdstring
watchersstring[]
timezonestring

IANA timezone, used with recurrence.

recurrenceobject

Optional repeat rule.

scheduledAtstring date-time required

Future ISO 8601 datetime.

Example request

{
  "title": "Launch announcement",
  "tags": [
    "launch"
  ],
  "providers": {
    "twitter": {
      "channelName": "@focusbox",
      "providerId": "tw_9f3a1c20e5",
      "content": {
        "text": "We just shipped v2. Faster, cleaner, yours.",
        "mediaUrls": [
          "https://cdn.postnext.io/assets/launch-hero.png"
        ],
        "mediaType": "IMAGE",
        "hashtags": [
          "launch",
          "v2"
        ]
      }
    }
  }
}

Response

Created and scheduled

successboolean

Example response

{
  "success": true
}

Changes

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