---
title: "Invite someone directly by email"
method: POST
path: "/api/me/email-invites"
---

# Invite someone directly by email

`POST /api/me/email-invites`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/me/email-invites`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Email the member's own invitation link, without requiring a waitlist entry. Same as invite_by_email. Five total invitees per member across email and shared-link joins by default, configurable with INVITE_LIMIT (0 means unlimited). Repeated successful invitations do not resend or consume allowance. Failed delivery can be retried within 23 hours; older uncertain deliveries require support review to avoid duplicate emails. Email invitations reserve a place, and redemption consumes that reservation without counting twice. Already admitted or invited addresses receive no duplicate email, including across inviters.

## Request body

- object
  - `email` string, required: Where to send the invite.

## Response `200`

Email accepted, or previously sent.

- EmailInvitation
  - `emailed` boolean, required: True only when this request sent a new email accepted by the provider; false for duplicates. Inbox delivery is not guaranteed.
  - `alreadyInvited` boolean, required: The address already has access or an invitation; no new email was sent.
  - `allowance` InviteAllowance, required
    - `limit` integer, nullable, required: Total invitation limit across email and shared links; null means unlimited.
    - `used` integer, required: Members admitted with the link plus unredeemed email reservations; each person counts once.
    - `remaining` integer, nullable, required: Remaining invitation places; null means unlimited.

## Other responses

- `400`: Invalid address or inviting yourself.
- `401`: No valid session or API key.
- `403`: Not admitted, still signing up, or email unverified.
- `409`: No invitations left, link revoked, or an existing delivery is in progress or uncertain.
- `503`: Email delivery unavailable or failed. No invitation was used.

---

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