---
title: "Invite user to an organization by email"
method: POST
path: "/organizations/{organization_id}/invitations"
tags: ["Organization Invitations"]
---

# Invite user to an organization by email

`POST /organizations/{organization_id}/invitations`

Creates an invitation to an organization for a user with the specified email address.

## Request body

- object
  - `email` string, email, required — The email address of the invitee.
  - `permissions` string[], required — The permissions the invitee should be given on the organization.
  - `force` boolean — Whether to cancel any pending invitation for the specified invitee, and create a new invitation.

## Response `201`

Created

- OrganizationInvitation
  - `id` string, uuid — The ID of the invitation.
  - `state` 'pending' | 'processing' | 'accepted' | 'cancelled' | 'error' — The invitation state.
  - `organization_id` string — The ID of the organization.
  - `email` string, email — The email address of the invitee.
  - `owner` object — The inviter.
    - `id` string, uuid — The ID of the user.
    - `display_name` string — The user's display name.
  - `created_at` string, date-time — The date and time when the invitation was created.
  - `updated_at` string, date-time — The date and time when the invitation was last updated.
  - `finished_at` string, date-time, nullable — The date and time when the invitation was finished.
  - `permissions` string[] — The permissions the invitee should be given on the organization.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `409` — Conflict when there already is a pending invitation for the invitee

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)