---
title: "Invite a member"
description: "Send an email invitation to join the workspace as admin or member; it expires after 48 hours. Idempotent: an address that already holds an open invitation gets it back with 200 and no second email. An address that is already a member is a 409 already_member. Team changes need a signed-in owner or admin (an OAuth token from an MCP sign-in, or the dashboard session): an API key answers 403."
canonical: https://docs.mentio.dev/api/members/create-invitation
markdown: https://docs.mentio.dev/api/members/create-invitation.mdx
---

# Invite a member

`POST /v1/members/invitations`

Send an email invitation to join the workspace as admin or member; it expires after 48 hours. Idempotent: an address that already holds an open invitation gets it back with 200 and no second email. An address that is already a member is a 409 already_member. Team changes need a signed-in owner or admin (an OAuth token from an MCP sign-in, or the dashboard session): an API key answers 403.

## Body

- `email` (required): The address to invite; it receives an email with a link to join.
- `role`: The role they join with. Ownership is only handed over in the dashboard.

## Responses

- 200: The open invitation this address already had
- 201: The invitation, emailed
- 401: Missing or invalid API key
- 403: The credential is an API key, or its person is not an owner or admin
- 409: The address is already a member (already_member)

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx