Publish content to a platform

Publish content to a platform by providing the account ID.

Check the publishing content page for detailed info on how to use this API.

Subscribe to the "CONTENTS.PUBLISH_SUCCESS", "CONTENTS.PUBLISH_READY" and "CONTENTS.PUBLISH_FAILURE" webhooks to receive a notification once the request is completed. With webhooks, you should use the check status of content publish API to check the detailed status of the publish request.

POST /v1/social/contents/publish

Basic auth

curl 'https://api.staging.insightiq.ai/v1/social/contents/publish' \
  --request POST \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  --header 'Content-Type: application/json' \
  --data '{
  "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",
  "title": "string",
  "description": "string",
  "type": "TWEET",
  "visibility": "PUBLIC",
  "retry": false,
  "additional_info": {
    "share_to_feed": false
  },
  "media": [
    {
      "media_type": "IMAGE",
      "source_media_url": "http://example.com",
      "source_thumbnail_url": "http://example.com",
      "thumbnail_offset": 0,
      "additional_info": {},
      "platform_playlist_external_id": "string",
      "platform_playlist_position": 1
    }
  ]
}'

{
  "data": {
    "id": "string",
    "user": {
      "id": "string",
      "name": "string"
    },
    "account": {
      "id": "string",
      "platform_username": "string"
    },
    "work_platform": {
      "id": "string",
      "name": "string",
      "logo_url": "string"
    },
    "status": "string",
    "title": "string",
    "format": "string",
    "type": "string",
    "description": "string",
    "visibility": "string",
    "additional_info": {
      "share_to_feed": false
    },
    "media": [
      {
        "media_type": "string",
        "source_media_url": null,
        "source_thumbnail_url": "string",
        "thumbnail_offset": 0,
        "additional_info": {},
        "platform_playlist_external_id": "string",
        "platform_playlist_position": 1
      }
    ],
    "published_info": {
      "content_id": "string",
      "url": "string",
      "media_url": "string",
      "thumbnail_url": "string",
      "published_at": "string",
      "platform_content_id": "string"
    }
  },
  "platform_error": {
    "type": "string",
    "error_code": "string",
    "message": "string"
  }
}

Returns the publish object, which is currently being processed.

Body

· PublishContentRequest

application/json

account_id string · uuid required

Unique ID of the account.

title string

Title of the post (put the entire text here for tweets).

description string

Description for the post being published. Supports HTML for certain platforms (eg. YouTube).

type string · enum required

Platform specific content type of the post being published.

values

TWEET
REELS
VIDEO
IMAGE
BLOG
THREAD

visibility string · default: PUBLIC· enum

Visibility of the post.

values

PUBLIC
PRIVATE
UNLISTED

retry boolean · default: false

Whether should retry posting the content in case of any technical failures. Our retry mechanism and policies are defined on our publishing content guide.

additional_info object

Platform specific fields come here.

media array of PublishContentMedia

List of media items to be published.

Body

Responses