---
title: "Invite a user to your organization by email"
method: POST
path: "/org-invitation"
tags: ["organizations"]
---

# Invite a user to your organization by email

`POST /org-invitation`

## Request

- Base URL: `https://api.zerotier.com/api/v1`
- URL: `https://api.zerotier.com/api/v1/org-invitation`
- Auth: HTTP token

## Request body

- OrganizationInvitation
  - `orgId` string: Organization ID
  - `email` string: Email address of invitee
  - `id` string: Invitation ID
  - `creation_time` integer: Creation time of the invite
  - `status` 'pending' | 'accepted' | 'canceled'
  - `update_time` integer: Last updated time of the invitation
  - `ownerEmail` string: Organization owner email address

## Response `200`

User invited to organization

- OrganizationInvitation
  - `orgId` string: Organization ID
  - `email` string: Email address of invitee
  - `id` string: Invitation ID
  - `creation_time` integer: Creation time of the invite
  - `status` 'pending' | 'accepted' | 'canceled'
  - `update_time` integer: Last updated time of the invitation
  - `ownerEmail` string: Organization owner email address

## Other responses

- `401`: Authorization required
- `403`: Access denied
- `404`: Item not found

---

[API](https://skmtc.dev/zerotier/apis/zerotier-legacy-central-api.md) - [All operations](https://skmtc.dev/zerotier/apis/zerotier-legacy-central-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zerotier/apis/zerotier-legacy-central-api/revisions/80c9c5bfd0a4?raw)