Create Schedule

POST /public/schedule

Create a scheduled post to be published to a connected platform at a specific time.

Supported Post Types

Type	Description	Supported Platforms
`text`	Text-only post	Facebook, Threads
`image`	Single image with caption	Facebook, Instagram, Threads, TikTok, LinkedIn
`video`	Single video post	Facebook, Instagram, Threads, TikTok, YouTube, LinkedIn
`reel`	Short-form video (Reel)	Facebook
`album`	Multiple images/videos	Facebook, Instagram, Threads, TikTok, LinkedIn
`link`	Link share with preview	Facebook
`story`	Temporary story content	Facebook, Instagram

Endpoint Details

Authentication: Basic Auth (Authorization: Basic Base64(AccessKey:SecretKey))
Access Tier: Premium+

Request Body

Field	Type	Required	Description
`title`	string	Yes	Title of the content (used for YouTube, etc.)
`description`	string	Yes	Caption or description of the post
`topic`	string	No	Topic for AI-generated content
`type`	string	Yes	Post type: `text`, `image`, `video`, `reel`, `album`, `link`, `story`
`medias`	array	Yes	Array of media objects (see below)
`meta`	object	No	Link metadata for `link` type posts
`meta.title`	string	No	Link preview title
`meta.description`	string	No	Link preview description
`meta.url`	string	No	Target URL for link posts
`additionalInfo`	object	No	Additional configuration (see below)
`additionalInfo.isAiGenerated`	boolean	No	Whether content is AI-generated
`additionalInfo.isDraft`	boolean	No	Whether to save as draft
`additionalInfo.collaborators`	array	No	Instagram collaborator usernames
`additionalInfo.mentions`	array	No	Usernames to mention (Instagram Story only)
`additionalInfo.music`	object	No	TikTok music attachment
`additionalInfo.products`	array	No	Shopee product attachments
`additionalInfo.tags`	array	No	YouTube tags for discoverability
`replies`	array	No	Nested replies for thread-style posts (Threads)
`accountId`	string	Yes	Target account ID to post to
`scheduleAt`	string	Yes	ISO 8601 datetime for scheduled publish time
`templateId`	string	No	Automation template ID to attach

Media Object

Field	Type	Description
`alt`	string	Alt text for accessibility
`customThumbnail`	boolean	Whether thumbnail is custom
`type`	string	`image` or `video`
`thumbnail`	string	Thumbnail URL
`url`	string	Media file URL

Example Request

cURLAxiosFetch

bash

curl -X POST "https://api.repliz.com/public/schedule" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "title": "", "description": "Hello World!", "type": "text", "medias": [], "accountId": "YOUR_ACCOUNT_ID", "scheduleAt": "2026-06-01T12:00:00.000Z" }'

javascript

import axios from 'axios';

const response = await axios.post('https://api.repliz.com/public/schedule', {
  title: '',
  description: 'Hello World!',
  topic: '',
  type: 'text',
  medias: [],
  meta: { title: '', description: '', url: '' },
  additionalInfo: {
    isAiGenerated: false,
    isDraft: false,
    collaborators: [],
    mentions: [],
    music: { id: '', artist: '', name: '', thumbnail: '' },
    products: [],
    tags: []
  },
  replies: [],
  accountId: 'YOUR_ACCOUNT_ID',
  scheduleAt: '2026-06-01T12:00:00.000Z'
}, {
  auth: {
    username: 'YOUR_ACCESS_KEY',
    password: 'YOUR_SECRET_KEY'
  }
});

console.log(response.data);

javascript

const credentials = btoa('YOUR_ACCESS_KEY:YOUR_SECRET_KEY');

const response = await fetch('https://api.repliz.com/public/schedule', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${credentials}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: '',
    description: 'Hello World!',
    type: 'text',
    medias: [],
    accountId: 'YOUR_ACCOUNT_ID',
    scheduleAt: '2026-06-01T12:00:00.000Z'
  })
});

const data = await response.json();
console.log(data);

Request Body Examples

Select a tab to see the request body for each post type:

json

{
  "title": "",
  "description": "Hola! This is example for post text",
  "topic": "AI Threads",
  "type": "text",
  "medias": [],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post image",
  "topic": "AI Threads",
  "type": "image",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "image",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/image.png"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "Hola! Title!",
  "description": "Hola! This is example for post video",
  "topic": "AI Threads",
  "type": "video",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "video",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/video.mp4"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [
      {
        "id": "50060886180",
        "name": "Baju Baru",
        "thumbnail": "https://cf.shopee.co.id/file/id-11134207-822wh-moho65xqkn4caa"
      }
    ]
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post reel",
  "topic": "",
  "type": "reel",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "video",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/video.mp4"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "Hola! Title!",
  "description": "Hola! This is example for post album",
  "topic": "",
  "type": "album",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "image",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/image.png"
    },
    {
      "alt": "",
      "type": "image",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/image.png"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post link",
  "topic": "",
  "type": "link",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "image",
      "thumbnail": "https://repliz.com/banner.png",
      "url": "https://repliz.com/banner.png"
    }
  ],
  "meta": {
    "title": "Repliz: Smart Comment Management for All Platforms",
    "description": "Repliz helps you manage comments from YouTube, Facebook, Instagram, Threads, TikTok and LinkedIn, all in one app. Automate replies, filter spam, and save time.",
    "url": "https://repliz.com"
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "",
  "topic": "",
  "type": "story",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "video",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/video.mp4"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post text",
  "topic": "AI Threads",
  "type": "text",
  "medias": [],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [
    {
      "title": "",
      "description": "Hola! This is example for post image",
      "topic": "AI Threads",
      "type": "image",
      "medias": [
        {
          "alt": "",
          "customThumbnail": false,
          "type": "image",
          "thumbnail": "https://storage.repliz.com/thumbnail.png",
          "url": "https://storage.repliz.com/image.png"
        }
      ]
    },
    {
      "title": "",
      "description": "Hola! This is example for post video",
      "topic": "AI Threads",
      "type": "video",
      "medias": [
        {
          "alt": "",
          "customThumbnail": false,
          "type": "video",
          "thumbnail": "https://storage.repliz.com/thumbnail.png",
          "url": "https://storage.repliz.com/video.mp4"
        }
      ]
    }
  ],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post text",
  "topic": "AI Threads",
  "type": "text",
  "medias": [],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z",
  "templateId": "680affa5ce12f2f72a16f67c"
}

json

{
  "title": "",
  "description": "Hola! This is example for post video with collaborators",
  "topic": "",
  "type": "video",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "video",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/video.mp4"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [
      "replizofficial"
    ],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post video with music",
  "topic": "",
  "type": "video",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "video",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/video.mp4"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "7602104441417107457",
      "artist": "CHAYRA",
      "name": "Mudik Raya",
      "thumbnail": "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/oYAl1dJBDECv7BjbCUFAQVZyeBfEpABEEVgntg.jpeg"
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post video with product",
  "topic": "",
  "type": "video",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "video",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/video.mp4"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [
      {
        "id": "43728134810",
        "name": "Foto Nikola Tesla",
        "thumbnail": "https://cf.shopee.co.id/file/id-11134207-8224x-mjobdglo1oubf4",
        "currency": "IDR",
        "price": 10000
      }
    ],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post video with tag",
  "topic": "",
  "type": "video",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "video",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/video.mp4"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [
      "AI YouTube",
      "AI Trend 2026"
    ]
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "",
  "topic": "",
  "type": "story",
  "medias": [
    {
      "alt": "",
      "customThumbnail": false,
      "type": "video",
      "thumbnail": "https://storage.repliz.com/thumbnail.png",
      "url": "https://storage.repliz.com/video.mp4"
    }
  ],
  "meta": {
    "title": "",
    "description": "",
    "url": ""
  },
  "additionalInfo": {
    "isAiGenerated": false,
    "isDraft": false,
    "collaborators": [],
    "mentions": [
      "username_to_mention"
    ],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

Response

200404401

json

{
  "scheduleId": "69c7532ff0c3b7c83ab9e681"
}

json

// Schedule not found
{
  "code": 404,
  "message": "schedule not found"
}

// Account not found
{
  "code": 404,
  "message": "account not found"
}

json

{
  "code": 401,
  "message": "unauthorized"
}

Create Schedule ​

Supported Post Types ​

Endpoint Details ​

Request Body ​

Media Object ​

Example Request ​

Request Body Examples ​

Response ​

Create Schedule

Supported Post Types

Endpoint Details

Request Body

Media Object

Example Request

Request Body Examples

Response