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 Threads
`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.isAutoAddMusic`	boolean	No	Whether to automatically add music to post
`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
`additionalInfo.targetCountries`	array	No	Target country codes (ISO 3166-1 alpha-2, e.g., `["ID", "US"]`) for audience targeting
`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,
      isAutoAddMusic: false,
      collaborators: [],
      mentions: [],
      music: { id: "", artist: "", name: "", thumbnail: "" },
      products: [],
      tags: [],
      targetCountries: [],
    },
    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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [
      {
        "id": "50060886180",
        "name": "Baju Baru",
        "thumbnail": "https://cf.shopee.co.id/file/id-11134207-822wh-moho65xqkn4caa"
      }
    ],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": ["replizofficial"],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "7602104441417107457",
      "artist": "CHAYRA",
      "name": "Mudik Raya",
      "thumbnail": "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/oYAl1dJBDECv7BjbCUFAQVZyeBfEpABEEVgntg.jpeg"
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "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": [],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": ["AI YouTube", "AI Trend 2026"],
    "mentions": [],
    "targetCountries": []
  },
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": ["username_to_mention"],
    "targetCountries": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-05-30T09:01:26.510Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post video with Pinterest link",
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": []
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-06-09T12:06:09.812Z"
}

json

{
  "title": "",
  "description": "Hola! This is example for post video with Pinterest link",
  "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,
    "isAutoAddMusic": false,
    "collaborators": [],
    "music": {
      "id": "",
      "artist": "",
      "name": "",
      "thumbnail": ""
    },
    "products": [],
    "tags": [],
    "mentions": [],
    "targetCountries": ["ID", "MY"]
  },
  "replies": [],
  "accountId": "680affa5ce12f2f72916f67e",
  "scheduleAt": "2026-06-09T12:06:09.812Z"
}

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