---
title: "Creates an organization (accessible to Secretariat)"
method: POST
path: "/registry/org"
tags: ["Registry Organization"]
---

# Creates an organization (accessible to Secretariat)

`POST /registry/org`

<h2>Access Control</h2>  <p>User must belong to an organization with the <b>Secretariat</b> role</p>  <h2>Expected Behavior</h2>  <p><b>Secretariat:</b> Creates a new organization</p>

## Headers

- `CVE-API-ORG` string, required
- `CVE-API-USER` string, required
- `CVE-API-KEY` string, required

## Request body

- union
  - SecretariatOrgJson — unresolved $ref
  - CNAOrgJson — unresolved $ref
  - ADPOrgJson — unresolved $ref
  - BulkDownloadOrgJson — unresolved $ref

## Response `200`

Returns information about all organizations, along with pagination fields if results span multiple pages of data

- ListRegistryOrgsResponseJson — unresolved $ref

## Other responses

- `400` — Bad Request
- `401` — Not Authenticated
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-07-20** `8dbf1b328a70` — 1 info
  - api operation id `orgCreateSingle` removed and replaced with `registryOrgCreateSingle`
- **2025-12-05** `7225ce9cee29` — 1 breaking, 2 warning, 3 info
  - added required request body
  - deleted the `query` request parameter `page`
  - deleted the `query` request parameter `registry`
  - api operation id `orgAll` removed and replaced with `orgCreateSingle`
  - …2 more
- **2025-11-04** `26ede34bbf48` — 1 info
  - endpoint added
- **2025-10-14** `2c44a137d9b0` — 1 breaking
  - api path removed without deprecation
- **2025-09-22** `27e4e9be9c5f` — 3 breaking, 10 info
  - added the new required `header` request parameter `CVE-API-KEY`
  - added the new required `header` request parameter `CVE-API-ORG`
  - added the new required `header` request parameter `CVE-API-USER`
  - api operation id `orgAll` was added
  - …9 more

[Full history](https://skmtc.dev/cveproject/apis/cve-services-api/changes/registry/org/post.md)

---

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