---
title: "Email an invitation into a Workspace the person owns or administers."
method: POST
path: "/api/v2/workspaces/{id}/invitations"
---

# Email an invitation into a Workspace the person owns or administers.

`POST /api/v2/workspaces/{id}/invitations`

## Request

- Base URL: `https://fintable.io`
- URL: `https://fintable.io/api/v2/workspaces/{id}/invitations`
- Auth: HTTP bearer

Requires the write scope and a role that manages members: the Owner may invite admin, editor or viewer; an Admin may invite editor or viewer (403 for a role the caller cannot grant). The Owner's plan must include team members (Office or Enterprise). The invitee accepts from the email with their own Fintable login, creating one on the invitation page when they have none; the API never sets a password for them. An address that is already a member is refused (409); a repeat for an address with an open invitation replaces it. Rate limited separately: 10 per minute and 200 per day per person, because each call sends an email.

## Path parameters

- `id` string, required

## Request body

- object
  - `email` string, email, required
  - `role` 'admin' | 'editor' | 'viewer', required

## Response `201`

The invitation, status pending.

- WorkspaceInvitationObject
  - `data` WorkspaceInvitation
    - `id` string: Opaque invitation ID (inv_...).
    - `email` string: The invited address, lowercased.
    - `role` 'admin' | 'editor' | 'viewer': The role the invitee receives on accepting.
    - `status` 'pending' | 'accepted' | 'revoked' | 'expired': pending until the invitee accepts (accepted), the inviter revokes it (revoked) or seven days pass (expired).
    - `created_at` string, date-time, nullable
    - `expires_at` string, date-time
    - `accepted_at` string, date-time, nullable
    - `revoked_at` string, date-time, nullable

## Other responses

- `403`: The standard error envelope.
- `404`: The standard error envelope.
- `409`: The standard error envelope.
- `422`: The standard error envelope.
- `429`: The standard error envelope.

---

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