Create a new managed organization within an existing organization.
If successful, this endpoint will return a 201 Created status.
One of the following scopes are required to use this endpoint.
The following arguments are supported for this endpoint.
| Name | Type | Default Value |
|---|---|---|
|
organization Required |
Organization Lookup | None |
|
name Required |
String | None |
|
sub_domain Required |
String | None |
The following errors may occur during this request.
| Details | HTTP status |
|---|---|
|
The maxmium number of organizations that can be created has been reached |
422 Unprocessable Entity |
|
An organization was found from the arguments provided but it wasn't activated yet |
403 Forbidden |
|
No organization was found matching any of the criteria provided in the arguments |
404 Not Found |
|
An organization was found from the arguments provided but it was suspended |
403 Forbidden |
|
A validation error occurred with the object that was being created/updated/deleted |
422 Unprocessable Entity |
When the request is successful, you can expect an object matching the specification below to be returned.
{ organization: Organization { id: String name: String sub_domain: String infrastructure_domain: String created_at: Unix Timestamp suspended: Boolean managed: Boolean billing_name: String? address1: String? address2: String? address3: String? address4: String? postcode: String? vat_number: String? currency: Currency { id: String name: String iso_code: String symbol: String } country: Country? { id: String name: String iso_code2: String iso_code3: String time_zone: String? eu: Boolean } country_state: CountryState? { id: String name: String code: String country: Country { id: String name: String iso_code2: String iso_code3: String time_zone: String? eu: Boolean } } } }