---
title: "Create a managed org"
method: POST
path: "/partner/managed-orgs"
tags: ["Partner"]
---

# Create a managed org

`POST /partner/managed-orgs`

## Request

- Base URL: `https://api.markmesh.com/v1`
- URL: `https://api.markmesh.com/v1/partner/managed-orgs`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Onboards a new client organisation under your partner-org. A single call provisions the workspace, creates the initial admin user inside it, and links your partner-org to it with full management rights across clients, trademarks, filings and watches. The new admin receives a magic-link sign-in email so they can access the workspace immediately. The workspace is fully partner-managed: billing, communications and operations all sit with your partner-org.

## Response `201`

Managed-organisation created. Response carries the new org's identity, the initial admin user (a magic-link sign-in email has been sent to them), and the PartnerRelationship that grants your partner-org access.

## Other responses

- `401`: API key or session credential missing, invalid, expired, or revoked
- `422`: Validation error — field-level detail in the response body

---

[API](https://skmtc.dev/markmesh/apis/markmesh-api.md) · [All operations](https://skmtc.dev/markmesh/apis/markmesh-api/llms.txt) · [OpenAPI document](https://skmtc.dev/markmesh/apis/markmesh-api/revisions/87d08d2479ee?raw)