---
title: "POST /availability/bulk-holidays"
method: POST
path: "/availability/bulk-holidays"
tags: ["availability"]
---

# POST /availability/bulk-holidays

`POST /availability/bulk-holidays`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/availability/bulk-holidays`
- Auth: one of:
  - API key in header `x-meetergo-api-user-id`
  - HTTP bearer
  - HTTP bearer

## Request body

- BulkHolidayExceptionsDto
  - `userIds` string[], required
  - `year` number, required
  - `germanState` 'BW' | 'BY' | 'ST' | 'MV' | 'BE' | 'BB' | 'HE' | 'NW' | 'RP' | 'SL' | 'SN' | 'TH' | 'SH' | 'HH' | 'NI' | 'HB'
  - `country` 'DE' | 'AT' | 'BE' | 'CA' | 'DK' | 'NL' | 'EE' | 'FI' | 'FR' | 'IT' | 'NZ' | 'ES' | 'SE' | 'CH' | 'US', required

## Response `201`

Holidays applied to multiple users

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)