Posts

Create and publish a post now

Creates a post group and publishes it immediately to every channel in the providers map. Partial success returns 200 with publishStatus.partial set to true (it is not an error).

post/api/posts/publish

Request

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

Created and published

successboolean

Example response

{
  "success": true
}

Changes

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