Create a Twitter post

curl --request POST \
  --url https://scheduler.dashsocial.com/twitter/scheduled_posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "brand_id": 1,
  "auto_publish": true,
  "tweet_status": "<string>",
  "media_ids": [
    1
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "replies": [
    {
      "alt_text_media_map": {},
      "approval_requests": [
        {
          "requested_by_user_id": 123,
          "review_user_id": 123
        }
      ],
      "auto_publish": true,
      "content_tag_ids": [
        1
      ],
      "duplicate_to_brand_ids": [
        1
      ],
      "id": 1,
      "media_ids": [
        1
      ],
      "post_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sort_index": 123,
      "subtitle_content": "<string>",
      "thread_order": 123,
      "tweet_status": "<string>"
    }
  ],
  "alt_text_media_map": {},
  "approval_requests": [
    {
      "requested_by_user_id": 123,
      "review_user_id": 123
    }
  ],
  "auto_numbering_enabled": true,
  "board_ids": [
    1
  ],
  "callback_socket_id": "<string>",
  "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,
  "subtitle_content": "<string>"
}
'

{
  "brand_id": 1,
  "auto_publish": true,
  "tweet_status": "<string>",
  "media_ids": [
    1
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "replies": [
    {
      "alt_text_media_map": {},
      "approval_requests": [
        {
          "brand_id": 123,
          "created_at": "2023-11-07T05:31:56Z",
          "deleted_at": "2023-11-07T05:31:56Z",
          "id": 123,
          "post_id": 123,
          "requested_by_user_id": 123,
          "review_user_id": 123,
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ],
      "approval_status": "<string>",
      "auto_publish": true,
      "content_tag_ids": [
        1
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "has_scheduled_time": true,
      "id": 1,
      "live_post_url": "<string>",
      "media": [
        {}
      ],
      "media_ids": [
        1
      ],
      "num_of_approvals_required": 123,
      "permalink": "<string>",
      "post_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sort_index": 123,
      "source_id": "<string>",
      "subtitle_content": "<string>",
      "subtitle_error_message": "<string>",
      "subtitle_metadata": {
        "filename": "<string>"
      },
      "subtitle_upload_status": "<string>",
      "thread_order": 123,
      "tweet_status": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "alt_text_media_map": {},
  "approval_requests": [
    {
      "brand_id": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "deleted_at": "2023-11-07T05:31:56Z",
      "id": 123,
      "post_id": 123,
      "requested_by_user_id": 123,
      "review_user_id": 123,
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "approval_status": "<string>",
  "auto_numbering_enabled": true,
  "board_ids": [
    1
  ],
  "callback_socket_id": "<string>",
  "campaign_ids": [
    1
  ],
  "content_tag_ids": [
    1
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "has_scheduled_time": true,
  "id": 1,
  "live_post_url": "<string>",
  "media": [
    {}
  ],
  "num_of_approvals_required": 123,
  "permalink": "<string>",
  "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,
  "source_id": "<string>",
  "subtitle_content": "<string>",
  "subtitle_error_message": "<string>",
  "subtitle_metadata": {
    "filename": "<string>"
  },
  "subtitle_upload_status": "<string>",
  "updated_at": "2023-11-07T05:31:56Z"
}

POST

twitter

scheduled_posts

Create a Twitter post

curl --request POST \
  --url https://scheduler.dashsocial.com/twitter/scheduled_posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "brand_id": 1,
  "auto_publish": true,
  "tweet_status": "<string>",
  "media_ids": [
    1
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "replies": [
    {
      "alt_text_media_map": {},
      "approval_requests": [
        {
          "requested_by_user_id": 123,
          "review_user_id": 123
        }
      ],
      "auto_publish": true,
      "content_tag_ids": [
        1
      ],
      "duplicate_to_brand_ids": [
        1
      ],
      "id": 1,
      "media_ids": [
        1
      ],
      "post_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sort_index": 123,
      "subtitle_content": "<string>",
      "thread_order": 123,
      "tweet_status": "<string>"
    }
  ],
  "alt_text_media_map": {},
  "approval_requests": [
    {
      "requested_by_user_id": 123,
      "review_user_id": 123
    }
  ],
  "auto_numbering_enabled": true,
  "board_ids": [
    1
  ],
  "callback_socket_id": "<string>",
  "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,
  "subtitle_content": "<string>"
}
'

{
  "brand_id": 1,
  "auto_publish": true,
  "tweet_status": "<string>",
  "media_ids": [
    1
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "replies": [
    {
      "alt_text_media_map": {},
      "approval_requests": [
        {
          "brand_id": 123,
          "created_at": "2023-11-07T05:31:56Z",
          "deleted_at": "2023-11-07T05:31:56Z",
          "id": 123,
          "post_id": 123,
          "requested_by_user_id": 123,
          "review_user_id": 123,
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ],
      "approval_status": "<string>",
      "auto_publish": true,
      "content_tag_ids": [
        1
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "has_scheduled_time": true,
      "id": 1,
      "live_post_url": "<string>",
      "media": [
        {}
      ],
      "media_ids": [
        1
      ],
      "num_of_approvals_required": 123,
      "permalink": "<string>",
      "post_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sort_index": 123,
      "source_id": "<string>",
      "subtitle_content": "<string>",
      "subtitle_error_message": "<string>",
      "subtitle_metadata": {
        "filename": "<string>"
      },
      "subtitle_upload_status": "<string>",
      "thread_order": 123,
      "tweet_status": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "alt_text_media_map": {},
  "approval_requests": [
    {
      "brand_id": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "deleted_at": "2023-11-07T05:31:56Z",
      "id": 123,
      "post_id": 123,
      "requested_by_user_id": 123,
      "review_user_id": 123,
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "approval_status": "<string>",
  "auto_numbering_enabled": true,
  "board_ids": [
    1
  ],
  "callback_socket_id": "<string>",
  "campaign_ids": [
    1
  ],
  "content_tag_ids": [
    1
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "has_scheduled_time": true,
  "id": 1,
  "live_post_url": "<string>",
  "media": [
    {}
  ],
  "num_of_approvals_required": 123,
  "permalink": "<string>",
  "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,
  "source_id": "<string>",
  "subtitle_content": "<string>",
  "subtitle_error_message": "<string>",
  "subtitle_metadata": {
    "filename": "<string>"
  },
  "subtitle_upload_status": "<string>",
  "updated_at": "2023-11-07T05:31:56Z"
}

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.

X-specific fields

Parameter	Description
`tweet_status`	Post 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",
  "timestamp": "2026-03-10T15:00:00Z",
  "tweet_status": "Launching something new today 🚀"
}

Notes

Standard X posts support up to 280 characters.
Accounts with X Premium can publish posts up to 25,000 characters.
Caption-only posts (no media) are supported.
Supports up to 4 images or 1 video. Images and videos cannot be mixed.

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

tweet_status

string

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.

replies

object[]

Maximum array length: 24

Show child attributes

alt_text_media_map

object

Mapping for the alt text of each media in the post

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

auto_numbering_enabled

boolean

board_ids

integer[]

The list of the board ids associated with the post.

Required range: x >= 0

callback_socket_id

string

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.

subtitle_content

string | null

Raw SRT subtitle file content as text

subtitle_metadata

object

Subtitle metadata including language code and filename

Show child attributes

Response

Created

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

tweet_status

string

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.

replies

object[]

Maximum array length: 24

Show child attributes

alt_text_media_map

object

Mapping for the alt text of each media in the post

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

approval_status

string

read-only

The approval status of the post.

auto_numbering_enabled

boolean

auto_publish_error

enum<string>

read-only

Available options:

ACCOUNT_RESTRICTED,

AGAINST_COMMUNITY_STANDARDS,

APPROVED_PUBLISHING_DATES_HAVE_NO_OVERLAP,

AUTO_PUBLISH_LIMIT_EXCEEDED,

DUPLICATE_POST,

FLAGGED_AS_SPAM,

INTERNAL,

INVALID_ACCOUNT_TYPE,

INVALID_AUTH,

INVALID_DESCRIPTION,

INVALID_IMAGE,

INVALID_PIN_BOARD,

INVALID_PRODUCT_TAGS,

INVALID_TARGETING,

INVALID_TITLE,

INVALID_VIDEO_THUMBNAIL,

MEDIA_CONTAINER_EXPIRED,

MISSING_AUTH,

OUTSIDE_OF_APPROVED_PUBLISHING_DATES,

PAGE_PUBLISHING_AUTH_REQUIRED,

PLATFORM_ERROR,

REJECTED,

TEXT_LENGTH_EXCEEDED

board_ids

integer[]

The list of the board ids associated with the post.

Required range: x >= 0

callback_socket_id

string

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

created_at

string<date-time>

read-only

The time when the post was created.

creation_source

enum<string>

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

Available options:

RSS_FEED

has_scheduled_time

boolean

read-only

Indicates if the post has a scheduled timestamp

integer

read-only

A unique id for the post.

Required range: x >= 0

live_post_url

string<url>

read-only

Link to the live published post.

media

object[]

read-only

The list of media attached to the post.

num_of_approvals_required

integer

read-only

The number of approvals required to approve the request.

permalink

string | null

read-only

Link to the live published post

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.

source_id

string | null

read-only

subtitle_content

string | null

Raw SRT subtitle file content as text

subtitle_error_message

string | null

read-only

Error message if subtitle upload failed

subtitle_metadata

object

Subtitle metadata including language code and filename

Show child attributes

subtitle_upload_status

string | null

read-only

Computed status: SUCCESS if no error, FAILED if error exists

updated_at

string<date-time>

read-only

The time when the post was last updated.

Delete a Facebook post Get Twitter posts

Documentation Index

​X-specific fields

​Publishing modes

​Example request

​Notes

Authorizations

Body

Response

X-specific fields

Publishing modes

Example request

Notes