Scheduling

Resolve UTC times and destination slots, verify the scheduled result, and edit or cancel the existing item.

Choose a specific publish time or the next free calendar slot, not both. An explicit scheduledTime does not bypass slot validation if useNextFreeSlot is also true. A scheduled result confirms the queue entry. Check publication after the chosen time if your workflow needs the live post URL.

Choose a time

1. Resolve the user's date, time, and timezone. Ask for the timezone when it is unknown.

2. Convert the chosen instant to a future UTC ISO 8601 timestamp, such as 2030-06-15T15:00:00Z. Replace example dates with the intended future date.

3. Set scheduledTime in the create-post request.

4. Read the returned scheduledTime and report it in the user's timezone.

For MCP, scheduledTime is a tool argument. For REST, it is a top-level sibling of post:

{
  "post": {
    "accountId": "ACCOUNT_ID_FROM_LOOKUP",
    "content": {
      "platform": "twitter",
      "text": "Scheduled post example",
      "mediaUrls": []
    },
    "target": { "targetType": "twitter" }
  },
  "scheduledTime": "2030-06-15T15:00:00Z"
}

The API parses and returns scheduled times in UTC. There is no separate timezone field in this create-post request. The web calendar's timezone setting controls the calendar experience.

Use the next free slot

1. Set up the calendar's schedule slots.

2. Set useNextFreeSlot: true in place of a specific scheduledTime.

3. Report the resolved time returned by Blotato.

If no matching slot or available time is found, post creation returns a validation error. Add or correct slots for the intended platform, account, and Page. Do not retry without scheduling fields unless the user authorizes immediate publishing.

In REST, useNextFreeSlot is a top-level sibling of post. For slot definitions and advanced REST scheduling, see Weekly posting schedule and Publish Post.

Edit or cancel a scheduled post

1. List schedules with blotato_list_schedules or GET /v2/schedules.

2. Read the selected scheduled post with blotato_get_schedule or GET /v2/schedules/:id.

3. Update it with blotato_update_schedule or PATCH /v2/schedules/:id, or cancel it with blotato_delete_schedule or DELETE /v2/schedules/:id.

4. Check the returned state or re-read the schedule to verify the change.

Use the scheduled post's ID from the schedule listing. See Scheduled Posts for update fields and preserved content.