---
title: "Create Bulk Sync Schedule"
method: POST
path: "/api/bulk/syncs/{sync_id}/schedules"
tags: ["Bulk Sync Schedules"]
---

# Create Bulk Sync Schedule

`POST /api/bulk/syncs/{sync_id}/schedules`

Adds a new schedule to a bulk sync.

A bulk sync can have multiple schedules attached; adding one here does not
replace existing schedules. Schedule times are interpreted in UTC.

Creating a schedule only affects future automatic executions. To run the
sync immediately, call
[`POST /api/bulk/syncs/{id}/executions`](../../../../../api-reference/bulk-sync/start).

## Path parameters

- `sync_id` string, uuid, required — Unique identifier of the bulk sync to add a schedule to.

## Headers

- `X-Polytomic-Version` string

## Request body

- CreateScheduleRequest
  - `schedule` BulkSyncScheduleAPI, required
    - `dayOfMonth` string — Day of the month (1-31) for monthly schedules.
    - `dayOfWeek` string — Day of the week for weekly schedules.
    - `frequency` 'manual' | 'continuous' | 'hourly' | 'daily' | 'weekly' | 'custom' | 'builder' | 'runafter' | 'multi' | 'dbtcloud', required
    - `hour` string — Hour of the day (0-23, in UTC) the schedule fires.
    - `minute` string — Minute of the hour (0-59) the schedule fires.
    - `month` string — Month of the year (1-12) for yearly schedules.
    - `selectiveMode` 'none' | 'incrementalFields' | 'nonincrementalFields'

## Response `200`

OK

- ScheduleEnvelope
  - `data` BulkBulkSyncSchedule
    - `createdAt` string, date-time
    - `createdBy` string, uuid
    - `dayOfMonth` string
    - `dayOfWeek` string
    - `deletedAt` string, date-time
    - `deletedBy` string, uuid
    - `frequency` 'manual' | 'continuous' | 'hourly' | 'daily' | 'weekly' | 'custom' | 'builder' | 'runafter' | 'multi' | 'dbtcloud', required
    - `hour` string
    - `isDefault` boolean
    - `minute` string
    - `month` string
    - `schemas` string[], nullable
    - `selectiveMode` 'none' | 'incrementalFields' | 'nonincrementalFields'
    - `syncId` string, uuid
    - `syncMode` 'normal' | 'refetch' | 'resync' | 'rebuild'
    - `updatedAt` string, date-time
    - `updatedBy` string, uuid

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/versions/b509e00e80aa/schema)