---
title: "POST /invitations/{invitationID}"
method: POST
path: "/invitations/{invitationID}"
tags: ["invitations"]
---

# POST /invitations/{invitationID}

`POST /invitations/{invitationID}`

Add users to an existing invitation

## Path parameters

- `invitationID` string, uuid, required

## Request body

- object
  - `emails` string[], required — The list of emails to add to the invitation
  - `shouldSendEmail` boolean, required — Whether or not to send an invitation email to the users. If false, the users will be allowed to signup via the invitation link, however they will not receive an email from Heartbeat inviting them to join.

## Response `200`

Successful response

## Other responses

- `401` — API Key is missing or invalid
- `404` — Could not find requested invitation

---

[API](https://skmtc.dev/heartbeat/apis/heartbeat-api.md) · [All operations](https://skmtc.dev/heartbeat/apis/heartbeat-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/heartbeat/heartbeat-api/revisions/6c3cf537d508/schema)