Posts

Create a draft post

Creates a draft post group. userId and teamId are resolved from the API key and must NOT be sent. Requires a current (non-delinquent) subscription and available monthly post quota.

post/api/posts

Request

  • Base URL: https://api-app.postnext.io
  • URL: https://api-app.postnext.io/api/posts
  • 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.

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

Draft created

successboolean

Example response

{
  "success": true
}

Changes

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