---
title: "Create a team invitation"
method: POST
path: "/profile/team/invitations"
tags: ["Team"]
---

# Create a team invitation

`POST /profile/team/invitations`

Invite a user to join your team by email. An invitation email is sent automatically. Returns 409 if the user already belongs to a team or an invitation is already pending.

## Request body

- TeamInvitationCreate
  - `email` string, email, required
  - `name` string, nullable
  - `role` 'member' | 'admin'

## Response `200`

Invitation created

- TeamInvitationResponse
  - `id` integer, required — Invitation ID.
  - `invited_email` string, email, required — Email address of the invited user.
  - `invited_name` string, nullable — Name of the invited user.
  - `role` string, required — Assigned role: 'member' or 'admin'.
  - `status` string, required — Invitation status: 'pending', 'accepted', 'revoked', or 'expired'.
  - `expires_at` string, date-time, required — Expiration date of the invitation.
  - `created_at` string, date-time, required — Creation date of the invitation.
  - `invited_by` TeamInvitationActor
    - `id` integer, required
    - `email` string, email, required
    - `first_name` string, nullable
    - `last_name` string, nullable
  - `accepted_user_id` integer, nullable — ID of the user who accepted the invitation.
  - `token` string, nullable — Invitation token (only returned on creation).

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content

---

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