---
title: "POST /teams/{team_name}/invitations"
method: POST
path: "/teams/{team_name}/invitations"
tags: ["teams"]
---

# POST /teams/{team_name}/invitations

`POST /teams/{team_name}/invitations`

Invite a user to join a team with their email address

## Path parameters

- `team_name` string, required — The unique name for the team.

## Request body

- object
  - `email` string, email, required
  - `role` 'admin' | 'member', required

## Response `200`

Response

- Invitation
  - `team_name` string, required — The unique name for the team.
  - `email` string, email, required
  - `role` string, required
  - `created_at` string, date-time, required

## Other responses

- `202` — Response, email failed to send
- `400` — Bad request
- `403` — Forbidden
- `422` — UnprocessableEntity
- `429` — Too Many Requests
- `500` — Internal Error

---

[API](https://skmtc.net/cloudquery/apis/cloudquery-openapi-spec.md) · [All operations](https://skmtc.net/cloudquery/apis/cloudquery-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudquery/cloudquery-openapi-spec/versions/4af580f9023b/schema)