---
title: "Invite a user to the agency"
method: POST
path: "/agencies/{agencyId}/invitations"
tags: ["agency-users"]
---

# Invite a user to the agency

`POST /agencies/{agencyId}/invitations`

## Request

- Base URL: `https://api.bokio.se/v1`
- URL: `https://api.bokio.se/v1/agencies/{agencyId}/invitations`
- Auth: HTTP bearer

Invite a user as an agency staff member.
Creates a pending invitation and sends an email.

**Scope:** `agency-users:write`

## Request body

- AgencyUserInvitationWriteModel
  - `email` string, email, required: Email address of the user to invite

## Response `200`

Invitation created

- UserInvitationGetModel
  - `id` string, uuid, required: Unique identifier for the invitation
  - `email` string, email, required: Email address of the invited user
  - `status` 'pendingInvitation', required: Status of the invitation

## Other responses

- `400`: Validation error

---

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