DocumentationAPI Reference
API Reference

Bulk Create Company Holidays

post
https://{companyDomain}.bamboohr.com/api/v1/holidays/bulk-insert

Creates multiple company holidays in one synchronous call. Each record follows the single-create semantics: it may be fully-specified or carry a globalHolidayUuid that seeds name, dates, and countries from the global catalog entry (mix-and-match within the same request). Records are processed in request order.

OAuth Scopes: holidays.write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
boolean
Defaults to false

When true, the entire batch is committed in a single transaction and any per-record failure aborts the whole request with a 422 (no records are created). When false, each record commits independently and failures are reported per record in a 207 response. Accepted values: true/false, 1/0, yes/no, on/off.

boolean
Defaults to false

When true, each entry in the response records array also includes the full created company holiday under the record key. Accepted values: true/false, 1/0, yes/no, on/off.

Body Params

Payload to create a company holiday. May be fully-specified or reference a global catalog entry via globalHolidayUuid. name and startDate are required unless seeded by globalHolidayUuid.

UUID of a global catalog entry. When supplied, the server seeds name, startDate, endDate, and countryCodes from the catalog entry; partner-supplied values override the catalog defaults.

The name of the holiday. Required when globalHolidayUuid is not supplied. 1-255 characters.

The start date of the holiday. Required when globalHolidayUuid is not supplied.

The end date of the holiday. Null means a single-day holiday. Must be greater than or equal to startDate.

boolean
Defaults to true

Whether the holiday is visible to all employees on calendars, independent of audience. Defaults to true.

countryCodes

Country filter as ISO 3166-1 alpha-2 codes. An empty array means no country filter. When omitted on a catalog-referenced create, the catalog entry's country is used.

audience
object
required

Who the holiday applies to

Pay treatment for the holiday. Null means no special pay handling.

Responses

Updated about 3 hours ago

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

Updated about 3 hours ago