curl -X POST 'https://api.openai.com/v1/organization/invites' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "example-email",
  "role": "reader"
}'

# POST /organization/invites (OpenAI API)
Base URL: https://api.openai.com/v1
Auth: Authorization; OpenAI admin key; required.
Request formats: application/json.
Last verified: 2026-10-20

> Create invite

## Critical Gotchas
* The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.
* Audio transcription uploads use multipart form data rather than a JSON request body.

## cURL
curl -X POST 'https://api.openai.com/v1/organization/invites' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "example-email",
  "role": "reader"
}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| email | body | string | Yes | Send an email to this address |
| role | body | string | Yes | `owner` or `reader` |
| projects | body | object[] | No | An array of projects to which membership is granted at the same time the org... |

## Response example
{"object":"organization.invite","id":"string"}

---
Need an API key? Get one at https://platform.openai.com/api-keys

POST

POST /organization/invites — OpenAI API

OpenAI admin key (required); https://api.openai.com/v1

OpenAI API

Create invite

Base URL: https://api.openai.com/v1
Auth: Authorization: Bearer <OPENAI_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 228 tokens · Vary: Accept

Critical gotchas

The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.

Audio transcription uploads use multipart form data rather than a JSON request body.

cURL

curl -X POST 'https://api.openai.com/v1/organization/invites' \  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \  -H 'Content-Type: application/json' \  -d '{  "email": "example-email",  "role": "reader"}'

Parameters

Name	In	Type	Required	Description
email	body	string	Yes	Send an email to this address
role	body	string	Yes	`owner` or `reader`
projects	body	object[]	No	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.

Response 200 OK

{
  "object": "organization.invite",
  "id": "string",
  "email": "string",
  "role": "owner",
  "status": "accepted",
  "created_at": 0,
  "expires_at": 0,
  "accepted_at": 0,
  "projects": [
    {
      "id": "string",
      "role": "member"
    }
  ]
}

Get a free OpenAI API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.