---
title: "Send Invitation"
method: POST
path: "/api/invitations/"
tags: ["Invitations"]
---

# Send Invitation

`POST /api/invitations/`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/invitations/`
- Auth: HTTP bearer

Send invitation to new team member

Requires: admin role
Creates invitation with 7-day expiry
Sends invitation email in background

## Request body

- InvitationCreateRequest: Send invitation request
  - `email` string, email, required
  - `role` string, required

## Response `201`

Successful Response

- InvitationResponse: Invitation response
  - `id` string, required
  - `organization_id` string, required
  - `email` string, required
  - `role` string, required
  - `invitation_token` string, required
  - `invited_by` string, nullable, required
  - `expires_at` string, date-time, required
  - `status` string, required
  - `accepted_at` string, date-time, nullable, required
  - `accepted_by` string, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)