---
title: "Create organization API key"
method: POST
path: "/v2/organizations/{organization_id}/access/api-keys"
tags: ["Organization Access V2"]
---

# Create organization API key

`POST /v2/organizations/{organization_id}/access/api-keys`

## Path parameters

- `organization_id` string, required — a string to be decoded into a number

## Request body

- object
  - `name` string, required
  - `scopes` string[], required
  - `project_access_mode` 'ALL_PROJECTS' | 'RESTRICTED', required
  - `project_ids` string[], required

## Response `200`

Success

- object
  - `id` integer, required — an integer
  - `name` string, required
  - `token` string, required
  - `created_at` string, required

## Other responses

- `400` — The request did not match the expected schema
- `401` — No API key was provided in the request
- `403` — The API key does not have permission to perform this action
- `404` — The requested resource was not found
- `429` — Too many requests have been made in a short period
- `500` — An unexpected error occurred on the server

## Changes

- **2026-09-02** `e04f76c478af` — 1 info
  - added the new `apple_search_ads:proxy` enum value to the request property `scopes/items/`

[Change history](https://skmtc.dev/superwall/apis/superwall-api-v2/changes/v2/organizations/:organization_id/access/api-keys/post.md)

---

[API](https://skmtc.dev/superwall/apis/superwall-api-v2.md) · [All operations](https://skmtc.dev/superwall/apis/superwall-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superwall/superwall-api-v2/revisions/e04f76c478af/schema)