---
title: "Invite by email (owner/admin; uses a seat). The link is emailed and returned once; valid 7 days."
method: POST
path: "/api/v1/teams/{id}/invites"
tags: ["Organizations"]
---

# Invite by email (owner/admin; uses a seat). The link is emailed and returned once; valid 7 days.

`POST /api/v1/teams/{id}/invites`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/teams/{id}/invites`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

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

## Response `201`

{ invite, link, is_delivered }

## Other responses

- `400`: Bad email or role
- `402`: All seats taken
- `403`: Not owner/admin
- `409`: Already on the team

---

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