MMS > Child organizations

The following endpoints allow you to manage child organizations.

List of child organizations

get

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/organizations/{organizationId}/managed-organizations

Retrieves the collection of child organizations. If no organization found response will contain empty array in managedOrganizations variable.

Refer to the MMS page for Make Managed Services (MMS) overview.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

organizationIdintegerRequired

The ID of the organization.

Example: 11

Responses

200

Successful response

application/json

get

/organizations/{organizationId}/managed-organizations

HTTPcURLJavaScriptPython

GET /api/v2/organizations/{organizationId}/managed-organizations HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "managedOrganizations": [
    {
      "organizationId": 40,
      "organizationName": "Your child organization",
      "operationsAllocated": 10000,
      "countryId": 1,
      "timezoneId": 113,
      "zoneId": 1,
      "zoneDomain": "eu1.make.com",
      "zoneName": "EU1"
    }
  ],
  "pg": {
    "sortBy": "name",
    "limit": 10000,
    "sortDir": "asc",
    "offset": 0
  }
}

Create child organization

post

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/organizations/{organizationId}/managed-organizations

A successful response contains information about the new organization and user.

The endpoint requires regionId and countryId in the request body. The regionId can be retrieved from the GET /enums/imt-regions endpoint, and the countryId can be found in GET /enums/countries.

The operations parameter must be a multiple of 10000. The user name can be an existing user or an external contact without a Make account yet.

Refer to the MMS page for Make Managed Services (MMS) overview.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

organizationIdintegerRequired

The ID of the organization.

Example: 11

Body

application/json

userEmailstring · emailOptional

userNamestringOptional

organizationNamestringOptional

regionIdintegerOptional

countryIdintegerOptional

operationsintegerOptional

Responses

200

Successful response

application/json

post

/organizations/{organizationId}/managed-organizations

HTTPcURLJavaScriptPython

POST /api/v2/organizations/{organizationId}/managed-organizations HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 145

{
  "userEmail": "[email protected]",
  "userName": "John Doe",
  "organizationName": "Your child organization",
  "regionId": 1,
  "countryId": 1,
  "operations": 10000
}

200

Successful response

{
  "userId": 123,
  "userEmail": "[email protected]",
  "userName": "John Doe",
  "userLanguage": "en",
  "userExisted": true,
  "childOrganizationId": 123,
  "newParentOperations": 10000,
  "domain": "eu1.make.com"
}

List of child organizations consumption

get

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/organizations/{organizationId}/managed-organizations-consumption

Retrieves the collection of child organizations with consumption of opertaions/credits. If no organization found response will contain empty array in managedOrganizationsConsumption variable.

Refer to the MMS page for Make Managed Services (MMS) overview.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

organizationIdintegerRequired

The ID of the organization.

Example: 11

Responses

200

Successful response

application/json

get

/organizations/{organizationId}/managed-organizations-consumption

HTTPcURLJavaScriptPython

GET /api/v2/organizations/{organizationId}/managed-organizations-consumption HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "managedOrganizationsConsumption": [
    {
      "organizationId": 40,
      "centicreditsConsumed": "12345",
      "centicreditsExtra": "12345",
      "operationsConsumed": 12345,
      "operationsExtra": 12345,
      "transferConsumed": "12345",
      "transferExtra": "12345"
    }
  ]
}

Update allocation of a child organization operations

patch

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/organizations/{organizationId}/managed-organizations/{childOrganizationId}

A successful response contains summary of new operation limits for parent and child organization.

The operations parameter must be a multiple of 10000.

Refer to the MMS page for Make Managed Services (MMS) overview.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

organizationIdintegerRequired

The ID of the organization.

Example: 11

childOrganizationIdintegerRequired

The ID of the child organization.

Example: 11

Body

application/json

operationsintegerOptional

Responses

200

Successful response

application/json

patch

/organizations/{organizationId}/managed-organizations/{childOrganizationId}

HTTPcURLJavaScriptPython

PATCH /api/v2/organizations/{organizationId}/managed-organizations/{childOrganizationId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "operations": 10000
}

200

Successful response

{
  "newParentOperations": 20000,
  "newChildOperations": 10000,
  "operationsDiff": 10000,
  "limitIncreased": true
}