Providers
Managed Service Provider

Create Provider Organization

This endpoint creates a new organization under the provider. To create an MSP trial child organization, set trial to true and optionally trialDurationDays.

post/providers/{provider_id}/organizations

Request

Request body

namestring
maxSystemUsersinteger

The maximum number of users allowed in this organization. Requires organizations.billing scope to modify.

trialboolean

When true, creates the child organization in an MSP time-based trial state (organization_create event includes timeBasedTrial and trialEndDate). Requires organizations.billing scope, provider organization creation to be enabled, and that MSP trial child organizations are enabled for the provider. Omit or set false for a standard child organization create.

trialDurationDaysinteger

Optional trial length in days. Only valid when trial is true. Must be one of the allowed trial durations (currently 30). Defaults to 30 days when omitted.

Example request

{
  "name": "Acme Inc",
  "maxSystemUsers": 10
}

Response

CREATED

idstring
namestring
maxSystemUsersinteger

The maximum number of users allowed in this organization. Requires organizations.billing scope to modify.

trialEndDatestring

Present on create when trial was true: calendar end date (YYYY-MM-DD) computed at create time. Also included on organization_create for downstream billing.

Example response

{
  "id": "624d9eae6849cf3b3f93dc56",
  "name": "Acme Inc"
}

Changes

No recorded changes to this operation across all 1 revision of this API.