Create a Threads post

curl --request POST \
  --url https://scheduler.dashsocial.com/threads/scheduled_posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "brand_id": 1,
  "auto_publish": true,
  "text": "<string>",
  "media_ids": [
    1
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "link": "<string>",
  "approval_requests": [
    {
      "requested_by_user_id": 123,
      "review_user_id": 123
    }
  ],
  "board_ids": [
    1
  ],
  "campaign_ids": [
    1
  ],
  "content_tag_ids": [
    1
  ],
  "duplicate_to_brand_ids": [
    1
  ],
  "post_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "rss_feed_id": 123,
  "rss_guid": "<string>",
  "rss_publish_date": "2023-11-07T05:31:56Z",
  "sort_index": 123
}
'

{
  "code": 123,
  "errors": {},
  "message": "<string>",
  "status": "<string>"
}

POST

threads

scheduled_posts

Create a Threads post

curl --request POST \
  --url https://scheduler.dashsocial.com/threads/scheduled_posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "brand_id": 1,
  "auto_publish": true,
  "text": "<string>",
  "media_ids": [
    1
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "link": "<string>",
  "approval_requests": [
    {
      "requested_by_user_id": 123,
      "review_user_id": 123
    }
  ],
  "board_ids": [
    1
  ],
  "campaign_ids": [
    1
  ],
  "content_tag_ids": [
    1
  ],
  "duplicate_to_brand_ids": [
    1
  ],
  "post_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "rss_feed_id": 123,
  "rss_guid": "<string>",
  "rss_publish_date": "2023-11-07T05:31:56Z",
  "sort_index": 123
}
'

{
  "code": 123,
  "errors": {},
  "message": "<string>",
  "status": "<string>"
}

This endpoint has platform-specific fields and publishing rules. See the full scheduling guide for a complete walkthrough including media upload, publishing modes, and examples.

Threads-specific fields

Parameter	Description
`text`	Post caption text

Publishing modes

Mode	`status`	`auto_publish`	`timestamp`
Publish immediately	`AUTOPUBLISHING`	`true`	Not required
Schedule for later	`SCHEDULED`	`true`	Required
Save as draft	`DRAFT`	`true` or `false`	Optional

Example request

{
  "auto_publish": true,
  "brand_id": 144,
  "status": "SCHEDULED",
  "text": "Something exciting is coming.",
  "media_ids": [621242772],
  "timestamp": "2026-03-10T15:00:00Z"
}

Notes

auto_publish is always treated as true, even if false is provided.
Caption-only posts (no media) are supported.
Supports up to 20 images. Video is not currently supported.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

brand_id

integer

The id of the brand to which the post belongs.

Required range: x >= 0

auto_publish

boolean

Whether the post should be auto published.

status

enum<string>

The current status of the post.

Available options:

AUTOPUBLISHING,

DRAFT,

EXPIRED,

FAILED,

IMPORTED,

MISSING_APPROVALS,

PARTIALLY_FAILED,

POSTED,

SCHEDULED,

SKIPPED,

USERS_NOTIFIED

text

string

Text content of the Threads post

Maximum string length: 500

media_ids

integer[]

The list of the media ids attached to the post.

Required range: x >= 0

timestamp

string<date-time> | null

The scheduled date & time for publishing the post.

link

string<url> | null

Link to associate to the post as a link preview.

approval_policy

enum<string>

The approval policy of the approval request

Available options:

APPROVAL_REQUIRED,

APPROVAL_NOT_REQUIRED

approval_requests

object[]

The list of approval requests associated with the post.

Show child attributes

board_ids

integer[]

The list of the board ids associated with the post.

Required range: x >= 0

campaign_ids

integer[]

The list of the campaign ids associated with the post.

Required range: x >= 0

content_tag_ids

integer[]

The list of the content tag ids associated with the post.

Required range: x >= 0

creation_source

enum<string>

To identify the user or the application that created the post.

Available options:

RSS_FEED

duplicate_to_brand_ids

integer[]

write-only

The list of duplicate to brand ids.

Maximum array length: 55

Required range: x >= 0

post_group_id

string<uuid>

The id of the post group associated with the post.

rss_feed_id

integer | null

Foreign key reference to the RSS feed table.

rss_guid

string | null

The unique identifier coming from RSS Feed.

rss_publish_date

string<date-time> | null

The timestamp of when an RSS feed item was published

sort_index

number

The sorted index for unscheduled posts.

Response

Unprocessable Entity

code

integer

Error code

errors

object

Errors

message

string

Error message

status

string

Error name

Delete a TikTok post Get Threads posts Get a list of Threads posts for the brand(s).

Documentation Index

​Threads-specific fields

​Publishing modes

​Example request

​Notes

Authorizations

Body

Response

Threads-specific fields

Publishing modes

Example request

Notes