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

# POST /organization/projects (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 project

## 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/projects' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "example-name"
}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| name | body | string | Yes | The friendly name of the project, this name appears in reports. |
| geography | body | string | No | Create the project with the specified data residency region. Your organizatio... |
| residency | body | string | No | Create the project with the specified residency configuration. Your organizat... |
| external_key_id | body | string | No | External key ID to associate with the project. |

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

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

POST

POST /organization/projects — OpenAI API

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

OpenAI API

Create project

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
→ 259 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/projects' \  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \  -H 'Content-Type: application/json' \  -d '{  "name": "example-name"}'

Parameters

Name	In	Type	Required	Description
name	body	string	Yes	The friendly name of the project, this name appears in reports.
geography	body	string	No	Create the project with the specified data residency region. Your organization must have access to Data residency functionality in order to use. See [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls) to review the functionality and limitations of setting this field. Deprecated: use `residency` instead. Do not provide both `geography` and `residency`.
residency	body	string	No	Create the project with the specified residency configuration. Your organization must have access to the requested residency configuration in order to use it. See [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls) to review the functionality and limitations of setting this field.
external_key_id	body	string	No	External key ID to associate with the project.

Response 200 OK

{
  "id": "string",
  "object": "organization.project",
  "name": "string",
  "created_at": 0,
  "archived_at": 0,
  "status": "string",
  "external_key_id": "string",
  "residency": "GLOBAL"
}

Get a free OpenAI API key → sponsored

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