---
title: "Invite multiple people"
method: POST
path: "/v1/invitations"
tags: ["Invitations"]
---

# Invite multiple people

`POST /v1/invitations`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/invitations`
- Auth: API key in header `GREPR-API-KEY`

## Request body

- Invitee
  - `email` string
  - `roleIds` string[]: Role IDs assigned to the invitation
  - `teamAssignments` TeamAssignment[]: Team-specific role assignments
    - `role` 'LEADER' | 'MEMBER', required: The role within the team
    - `teamId` string, required: The ID of the team
    - `teamName` string: Team name (response-only, enriched by server)

## Response `200`

Invitations created successfully

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/grepr/apis/grepr-api.md) - [All operations](https://skmtc.dev/grepr/apis/grepr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grepr/apis/grepr-api/revisions/2a5ce03a0bf0?raw)