---
title: "Invite a user to a team"
method: POST
path: "/api/teams/{team}/invitations"
tags: ["TeamInvitation"]
---

# Invite a user to a team

`POST /api/teams/{team}/invitations`

## Request

- Base URL: `https://api.chipprofessionals.com`
- URL: `https://api.chipprofessionals.com/api/teams/{team}/invitations`
- Auth: HTTP bearer

## Path parameters

- `team` integer, required

## Request body

- object
  - `email` string, email: Invitee email; no request-level validation rule is defined
  - `role` string, nullable

## Response `200`

Invitation created

- SuccessResponse: Standard success response format
  - `success` boolean
  - `message` string
  - `data` unknown

## Other responses

- `401`: Unauthenticated
- `403`: Not authorized to add team members
- `404`: Team not found
- `422`: Invalid role
- `429`: Rate limited

---

[API](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation.md) - [All operations](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation/revisions/05e58f424c25?raw)