Skip to main content
POST
/
api
/
v1
/
posts
/
schedule
Create a scheduled post
curl --request POST \
  --url https://apix.us.amity.co/api/v1/posts/schedule \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduledAt": "2025-08-15T10:00:00Z",
  "postData": {
    "data": {
      "title": "<string>",
      "text": "example text",
      "streamId": "81559bcc3a5bb3b6bbd69a83b89d337e",
      "pollId": "53a9fd8b5aaa1af6c5a1bbd245ce4a9b1627373735551"
    },
    "attachments": [
      {
        "fileId": "57b916d38eaf8010caddfb7759a2d06c",
        "type": "image",
        "displayMode": "fill",
        "isMuted": "true"
      }
    ],
    "dataType": "upstra.customtype",
    "targetType": "user",
    "targetId": "public_user_id",
    "metadata": {
      "anything": "you want"
    },
    "postId": "postidiwant",
    "tags": [
      "<string>"
    ],
    "hashtags": [
      "tech_news",
      "startup_life",
      "product_launch",
      "innovation_2025"
    ],
    "mentionees": [
      {
        "type": "user",
        "userIds": [
          "userId1",
          "userId2"
        ]
      }
    ],
    "createdAt": "2022-07-07T04:24:20.444Z",
    "isDiscoverable": true
  }
}'
{
  "data": {
    "id": "<string>"
  }
}

Authorizations

Authorization
string
header
required

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

Body

application/json
scheduledAt
string<date-time>
required

When the post should be published

Example:

"2025-08-15T10:00:00Z"

postData
object
required

Response

Scheduled post created successfully

data
object