---
title: "Invite a person by email with a role (owner only)"
method: POST
path: "/v1/me/team/invitations"
---

# Invite a person by email with a role (owner only)

`POST /v1/me/team/invitations`

## Request

- Base URL: `https://api.grundfast.dk`
- URL: `https://api.grundfast.dk/v1/me/team/invitations`
- Auth: API key in cookie `gf_session`

Roles: developer, billing, read_only (ownership is given by promoting a member). The invitation holds a seat until it is accepted, withdrawn or expires (7 days); 402 `seat_limit` when the plan has none left. When no email can be sent, the response carries the accept `link` for the owner to share.

## Request body

- TeamInviteInput
  - `email` string, email, required
  - `role` 'developer' | 'billing' | 'read_only', required

## Response `201`

Created

## Other responses

- `400`: Error
- `402`: Error
- `403`: Error
- `409`: Error

---

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