---
title: "Invite someone by email (owner); they join when they sign in with it"
method: POST
path: "/members"
tags: ["Dashboard"]
---

# Invite someone by email (owner); they join when they sign in with it

`POST /members`

## Request

- Base URL: `https://api.eu.doconda.com/v1`
- URL: `https://api.eu.doconda.com/v1/members`
- Auth: HTTP bearer

## Request body

- object
  - `email` string, email, required
  - `role` 'owner' | 'member': owner: billing, members and settings. member: everything else.

## Response `201`

Invited.

- object
  - `id` string, required
  - `email` string, required
  - `role` 'owner' | 'member', required: owner: billing, members and settings. member: everything else.
  - `status` 'active' | 'invited', required: invited: joins the first time they sign in with this email.
  - `created_at` string, date-time, required

## Other responses

- `401`: unauthorized (missing, unknown or revoked key; expired session).
- `403`: forbidden
- `409`: already_member

---

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