SMAO API Documentation
Distributor API v1Organizations

Get organization

GET
/organizations/{organizationId}

Authorization

DistributorApiKey
AuthorizationBearer <token>

Long-lived distributor API key scoped to a channel partner on the shared smao instance.

In: header

Path Parameters

organizationId*string

MongoDB ObjectId of the organization.

Match^[a-fA-F0-9]{24}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/organizations/665abc123def456789012345"
{  "status": "success",  "organization": {    "id": "69c175970f3e28310926a1aa",    "name": "string",    "industry": "string",    "timezone": "string",    "channelPartner": "acme",    "externalCustomerId": "string",    "externalContractId": "string",    "partnerId": "665abc123def456789012345",    "ownerEmail": "user@example.com",    "createdAt": "2019-08-24T14:15:22Z",    "plan": {      "id": "6967b1c7138bed3e7f6bf7e6",      "slug": "string",      "name": "string",      "commitment": "none",      "currency": "string",      "baseFee": 0    }  }}

Create organization and initial owner invitation POST

Creates a new customer organization under the specified partner (MSP), creates its owner invitation record, and attempts to send the invitation email.

Update organization PATCH

Update allowed fields on a partner-managed organization. At least one field must be provided. If **externalCustomerId** is changed, uniqueness is enforced within the partner's organizations.