---
title: "Bulk handoff appointments"
method: POST
path: "/v4/handoff/bulk"
tags: ["Handoff V4"]
---

# Bulk handoff appointments

`POST /v4/handoff/bulk`

## 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/v4/handoff/bulk`
- Auth: one of:
  - API key in header `x-meetergo-api-user-id`
  - HTTP bearer
  - HTTP bearer

Hands off multiple appointments from specified users within a time period to a target user.

## Request body

- BulkHandoffDto
  - `userId` string[], required: Array of user IDs to handoff appointments from
  - `start` string, required: Period start date in ISO format
  - `end` string, required: Period end date in ISO format
  - `targetUserId` string: Target user ID to handoff appointments to
  - `enableAvailabilityCheck` boolean: Enable availability check during handoff
  - `targetUserIds` string[]: Array of target user IDs to distribute appointments across (round-robin)
  - `appointmentIds` string[]: Specific appointment IDs to handoff (cherry-pick). If not provided, all matching appointments are included.
  - `ignoreAvailability` boolean: If true, ignore availability conflicts and force handoff all appointments

## Response `200`

Bulk handoff completed successfully

- BulkHandoffResponseDto
  - `success` string[], required: Array of appointment IDs that were successfully handed off
  - `conflicts` string[]: Array of appointment IDs that could not be handed off due to conflicts

## Other responses

- `201`
- `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)