Bulk import agent schedule events from CSV

Bulk imports agent schedule events (shifts, time off, breaks, meetings) from a CSV file. Use this endpoint to synchronize agent schedules from external HRIS, scheduling systems, or workforce applications.

Submits a CSV file for asynchronous processing and returns a 202 Accepted response. The response includes a Location header with the URI to poll for import status. When processing completes, check the status endpoint to retrieve any error details in downloadable CSV format.

This endpoint enables adherence tracking integration from external systems without requiring manual re-entry of schedules in the WFM UI.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

CSV file containing agent schedule events. File must contain valid headers matching the schema (e.g., agent_id, event_type, start_time, end_time). Maximum file size is 5 MB.

Multipart form data for importing schedule events from a CSV file.

file
required
length between 1 and 5242880

CSV file containing schedule events to import.

string
required
length between 1 and 255

Name of the CSV file.

string
required
length between 1 and 64

Timezone for interpreting event times (e.g. UTC, America/New_York).

string
length between 1 and 64
Defaults to HH:mm yyyy-MM-dd

Date/time format pattern used in the CSV (e.g. HH:mm yyyy-MM-dd).

Responses

Language
Credentials
OAuth2
Missing 1 required scope
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*
application/json