SMAO API Documentation
Distributor API v1Partners

Create partner

POST
/partners

Creates a new partner (MSP) and automatically provisions a SMAO organization for them.

The response's organizationId is the MSP's new organization, billed by you. SMAO also tries to start a trial and, when contactEmail is given, to send an admin invitation; neither is guaranteed.

Authorization

DistributorApiKey
AuthorizationBearer <token>

Long-lived distributor API key, scoped to your distributor account.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/partners" \  -H "Content-Type: application/json" \  -d '{    "name": "MSP Hamburg GmbH",    "externalPartnerId": "MSP-001",    "contactEmail": "admin@msp-hamburg.de",    "contactName": "Ada Admin",    "timezone": "Europe/Berlin"  }'
{  "status": "success",  "partner": {    "id": "665abc123def456789012345",    "name": "MSP Hamburg GmbH",    "externalPartnerId": "MSP-001",    "contactEmail": "admin@msp-hamburg.de",    "contactName": "Hans Mueller",    "isActive": true,    "notes": null,    "organizationId": "665abc123def456789012346",    "organizationCount": 12,    "createdAt": "2026-03-20T10:41:14.553Z"  }}

List partners GET

Returns a paginated list of all partners (MSPs) under your distributor account. Each partner includes an `organizationCount` showing how many customer organizations are linked to it. Use the `externalPartnerId` query parameter to filter by your own partner identifier.

Get partner GET

Get partner