---
title: "Create an invite for a user to the organization. The invite must be accepted by the user before they have access to the organization."
method: POST
path: "/organization/invites"
tags: ["Invites"]
---

# Create an invite for a user to the organization. The invite must be accepted by the user before they have access to the organization.

`POST /organization/invites`

## Request body

- InviteRequest
  - `email` string, required — Send an email to this address
  - `role` 'reader' | 'owner', required — `owner` or `reader`
  - `projects` object[] — An array of projects to which membership is granted at the same time the org invite is accepted. If omitted, the user will be invited to the default project for compatibility with legacy behavior. If empty list is passed, the user will not be invited to any projects, including the default one.
    - `id` string, required — Project's public ID
    - `role` 'member' | 'owner', required — Project membership role

## Response `200`

User invited successfully.

- Invite — Represents an individual `invite` to the organization.
  - `object` 'organization.invite', required — The object type, which is always `organization.invite`
  - `id` string, required — The identifier, which can be referenced in API endpoints
  - `email` string, required — The email address of the individual to whom the invite was sent
  - `role` 'owner' | 'reader', required — `owner` or `reader`
  - `status` 'accepted' | 'expired' | 'pending', required — `accepted`,`expired`, or `pending`
  - `created_at` integer, required — The Unix timestamp (in seconds) of when the invite was sent.
  - `expires_at` integer, nullable — The Unix timestamp (in seconds) of when the invite expires.
  - `accepted_at` integer, nullable — The Unix timestamp (in seconds) of when the invite was accepted.
  - `projects` object[], required — The projects that were granted membership upon acceptance of the invite.
    - `id` string, required — Project's public ID
    - `role` 'member' | 'owner', required — Project membership role

---

[API](https://skmtc.net/openai/apis/openapi.md) · [All operations](https://skmtc.net/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openai/openapi/revisions/63028c4d3916/schema)