---
title: "Bulk Schedule"
method: POST
path: "/api/v1/humanpost/bulk-schedule"
tags: ["humanpost"]
---

# Bulk Schedule

`POST /api/v1/humanpost/bulk-schedule`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/humanpost/bulk-schedule`
- Auth: HTTP bearer

Create many posts in the background. Returns a ``task_id`` at once; poll
``GET /humanpost/bulk-schedule/{task_id}`` for per-item accepted/rejected.

## Request body

- DtoRequestHumanpostDTOBulkScheduleDTO
  - `items` BulkScheduleItemDTO[], required
    - `accountIds` string[], required
    - `skipApproval` boolean, nullable
    - `priority` integer, nullable
    - `scheduledAfter` string, nullable
    - `expiresAt` string, nullable
    - `caption` string, nullable
    - `hashtags` string[], nullable
    - `sound` SoundDTO
      - `mode` 'trending' | 'original' | 'specific', required
      - `url` string, nullable
      - `urlsByPlatform` object, nullable
    - `notes` string, nullable
    - `contentGroupIds` string[], nullable
    - `instagramPostFormat` 'reel' | 'post', nullable
    - `kind` 'video' | 'image', required
    - `mediaUrls` string[], required
    - `slides` SlideDTO[], nullable
      - `image` string, required
      - `textElements` TextElementDTO[], required
        - `content` string, required
        - `style` TextStyleDTO, required
          - `positionY` number, required
          - `positionX` number, nullable
          - `backgroundColor` string, nullable
          - `textColor` string, nullable
          - `fontSize` number, nullable
          - `fontWeight` unknown
          - `textAlign` string, nullable
          - `textMode` 'stroke' | 'background' | 'plain' | 'snapchat', nullable
          - `width` number, nullable
          - `padding` number, nullable
      - `imageFit` 'fit' | 'fill', nullable
      - `role` 'hook' | 'middle' | 'cta', nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 37 revisions in range; 1 not diffed.

- **2026-11-02** `f84fc05f417b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/humanpost/bulk-schedule/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/02d28bde684c?raw)