Organizations

Organizations are main containers that contain all teams, scenarios, and users. The API endpoints discussed further allow you to manage organizations. Read more about organizationsarrow-up-right.

List user organizations

get
/organizations

Retrieves a collection of all organizations, in which the user has membership. The response contains information about the organization name, organizationId and timezoneId. You can get more data about the user organizations with specifying the cols[] query parameter.

However, the values for parameters license, serviceName and isPaused are returned only for organizations in your current Make zone.

Returned organizations are sorted by the organization name in ascending order by default. You can specify sorting order with the query parameter pg[sortBy].

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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.

Query parameters
zonestringOptional

The URL of your Make instance domain.

Example: eu1.make.com
externalIdstringOptional

Make White Label product instances use the externalId parameter for security reasons. This parameter has null value in the public Make Cloud instance.

Example: {"value":"TESTORG003"}
colsstring[]Optional

Specifies columns that are returned in the response. Use the cols[] parameter for every column that you want to return in the response. For example GET /endpoint?cols[]=key1&cols[]=key2 to get both key1 and key2 columns in the response.

Check the "Filtering" section for a full example.

Example: {"value":["id","name","countryId","timezoneId","license","zone","serviceName","teams","isPaused","externalId","productName"]}
pg[sortBy]stringOptional

The value that will be used to sort returned entities by.

pg[offset]integerOptional

The value of entities you want to skip before getting entities you need.

pg[sortDir]string · enumOptional

The sorting order. It accepts the ascending and descending direction specifiers.

Possible values:
pg[limit]integerOptional

Sets the maximum number of results per page in the API call response. For example, pg[limit]=100. The default number varies with different API endpoints.

Responses
chevron-right
200

Successful response

application/json
get
/organizations
200

Successful response

Create an organization

post
/organizations

Create a new organization using the data sent in the request body. Successful response contains all information about the created organization.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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.

Body
namestringRequired

The name of the organization.

regionIdintegerRequired

ID of the Make region instance associated with the organization. Get the list of Make regions with the API call GET /enums/imt-regions.

timezoneIdintegerRequired

The ID of the timezone associated with the organization. Get the list of the timezone IDs with the API call GET /enums/timezones.

countryIdintegerRequired

The ID of the country associated with the organization. Get the list of the country IDs with the API call GET /enums/countries.

Responses
chevron-right
200

Successful response

application/json
post
/organizations
200

Successful response

Invitation detail

get
/organizations/invitation
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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.

Query parameters
hashstringRequiredExample: bf1effe1-bc9d-4ab3-9414-9c3b66175305
Responses
chevron-right
200

Successful response

application/json
get
/organizations/invitation
200

Successful response

Accept invitation

post
/organizations/accept-invitation
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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.

Body
hashstringRequired
Responses
chevron-right
200

Successful response

application/json
post
/organizations/accept-invitation
200

Successful response

Get organization details

get
/organizations/{organizationId}

Retrieves detail information of the organization with the specified organizationId.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Query parameters
waitbooleanOptional

Set this parameter to true if you are using the API call GET /organizations/{organizationId} shortly after creating the organization. The API call will first check synchronization of the Make backend and your Make zone data. If you don't use this argument, the API call might fail with an error due to unfinished data synchronization. The default value of this argument is false.

Example: true
Responses
chevron-right
200

Successful response

application/json
get
/organizations/{organizationId}
200

Successful response

Delete an organization

delete
/organizations/{organizationId}

Deletes the organization with the specified organizationId. Make also deletes all the teams in the organization. You can only delete organizations that are associated with your current Make zone. Your current Make zone is specified in the API call URL. Currently, it is either:

  • eu1.make.com

  • us1.make.com

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Query parameters
confirmedbooleanOptional

Set to true to confirm the organization deletion. Otherwise, if the organization has active scenarios, Make won't delete the organization and the API call returns an error.

Example: true
Responses
chevron-right
200

Successful response

application/json
delete
/organizations/{organizationId}
200

Successful response

Update organization information

patch
/organizations/{organizationId}

Updates the organization data with the values in the request body. If you don't use a parameter in the request body, Make won't change its value. You can update organization name, timezone, and country with the name, timezoneId, and countryId parameters.

Check the available values for the timezoneId and countryId parameters with the API calls GET /enums/timezones and GET /enums/countries.

The request response returns all organization data.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
namestringOptional

The new name of the organization.

countryIdintegerOptional

The ID of the country associated with the organization. Get the list of the country IDs with the API call GET /enums/countries.

timezoneIdintegerOptional

The ID of the timezone associated with the organization. Get the timezoneId values with the API call GET /enums/timezones.

Responses
chevron-right
200

Successful response

application/json
patch
/organizations/{organizationId}
200

Successful response

Get a list of custom apps

get
/organizations/{organizationId}/apps

Get list of custom apps associated with the users in the organization. The request response contains information of both published and unpublished custom apps. The custom app name is suffixed with a random text string.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
chevron-right
200

Successful response

application/json
get
/organizations/{organizationId}/apps
200

Successful response

Get list of past payments

get
/organizations/{organizationId}/payments
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Query parameters
pg[sortBy]stringOptional

The value that will be used to sort returned entities by.

pg[offset]integerOptional

The value of entities you want to skip before getting entities you need.

pg[sortDir]string · enumOptional

The sorting order. It accepts the ascending and descending direction specifiers.

Possible values:
pg[limit]integerOptional

Sets the maximum number of results per page in the API call response. For example, pg[limit]=100. The default number varies with different API endpoints.

Responses
chevron-right
200

Successful response

application/json
get
/organizations/{organizationId}/payments
200

Successful response

Create a single payment

post
/organizations/{organizationId}/single-payment-create
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Body
priceIdnumberRequired
quantitynumberRequired
couponCodestringOptional
Responses
chevron-right
200

Successful response

application/json
post
/organizations/{organizationId}/single-payment-create
200

Successful response

Get detail of an active subscription

get
/organizations/{organizationId}/subscription
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Responses
chevron-right
200

Successful response

application/json
get
/organizations/{organizationId}/subscription
200

Successful response

Create a new subscription

post
/organizations/{organizationId}/subscription
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Body
priceIdnumberRequired
couponCodestringOptional
Responses
chevron-right
200

Successful response

application/json
post
/organizations/{organizationId}/subscription
200

Successful response

Cancel the active subscription

delete
/organizations/{organizationId}/subscription
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Responses
chevron-right
200

Successful response

application/json
delete
/organizations/{organizationId}/subscription
200

Successful response

Change subscription

patch
/organizations/{organizationId}/subscription
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Body
priceIdnumberRequired
Responses
chevron-right
200

Successful response

application/json
patch
/organizations/{organizationId}/subscription
200

Successful response

Sets Free plan subscription

post
/organizations/{organizationId}/subscription-free
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Query parameters
confirmedbooleanOptional
Responses
chevron-right
200

Successful response

application/json
post
/organizations/{organizationId}/subscription-free
200

Successful response

Apply a coupon

post
/organizations/{organizationId}/subscription/coupon-apply
chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Query parameters
couponCodestringRequired
Body
Responses
chevron-right
200

Successful response

application/json
post
/organizations/{organizationId}/subscription/coupon-apply
200

Successful response

Invite a user to the organization

post
/organizations/{organizationId}/invite

Invite a user to the organization. To automatically add the user to teams, specify IDs of the teams. The user gets the team role member. You can change the user team role with the API call POST /users/{userId}/user-team-roles/{teamId}.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
usersRoleIdintegerOptional

The ID of the user organization role assigned to the invited user. Get list of user role IDs from the API call GET /users/roles.

emailstring · emailRequired

The user registration email.

namestringRequired

The user name visible in the team and organization interface.

notestringOptional

Note added to the invitation.

teamsIdinteger[]Optional

The list of team IDs to which the invited user will be assigned. The invited user will receive the team role member.

Responses
chevron-right
200

Successful response

application/json
post
/organizations/{organizationId}/invite
200

Successful response

List organization variables

get
/organizations/{organizationId}/variables

Retrieves the collection of organization variables. The response contains all organization variables if your account has the custom variables feature available. Otherwise, the response contains only Make system variables.

Check availability of the custom variables feature with the API call GET /organizations/{organizationId}. If the response contains "customVariables": true pair in the license object then you have access to the custom variables feature.

Refer to the Make pricing pagearrow-up-right for Make pricing plans overview.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
chevron-right
200

Successful response

application/json
get
/organizations/{organizationId}/variables
200

Successful response

Create organization variable

post
/organizations/{organizationId}/variables

Creates new organization variable. You can check the availability of the custom variables feature with the API call GET /organizations/{organizationId}. If the response contains "customVariables": true pair in the license object then you have access to the custom variables feature.

A successful response contains all information about the new variable. If you don't have the custom variables feature available then the API call returns the error 404.

Refer to the Make pricing pagearrow-up-right for Make pricing plans overview.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
typeIdnumberOptional

Number representing the type of the custom variable. The mapping of typeId and variable types is as follows:

  • 1: number,
  • 2: string,
  • 3: boolean,
  • 4: datein ISO 8601 compliant format YYYY-MM-DDTHH:mm:ss.sssZ. For example: 1998-03-06T12:31:00.000Z.
valueone ofOptional

Value assigned to the custom variable.

stringOptional
or
booleanOptional
or
numberOptional
or
or
namestringOptional

The name of the variable. You can use letters, digits, $ and _ characters in the custom variable name.

Responses
chevron-right
200

Successful response

application/json
post
/organizations/{organizationId}/variables
200

Successful response

Delete organization variable

delete
/organizations/{organizationId}/variables/{variableName}

Deletes organization variable.

If you don't have the custom variables feature available then the API call returns the error 404. Check the availability of the custom variables feature with the API call GET /organizations/{organizationId}. If the response contains "customVariables": true pair in the license object then you have access to the custom variables feature.

Refer to the Make pricing pagearrow-up-right for Make pricing plans overview.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
variableNamestringRequired

The name of the custom variable.

Example: userID
Query parameters
confirmedbooleanOptional

Set to true to confirm deleting the custom variable. Otherwise the API call fails with the error IM004 (406).

Example: true
Responses
chevron-right
200

Successful response

application/json
delete
/organizations/{organizationId}/variables/{variableName}
200

Successful response

Update organization variable

patch
/organizations/{organizationId}/variables/{variableName}

Updates custom organization variable with the specified variable name. Only parameters specified in the request body are updated.

You can check the availability of the custom variables feature with the API call GET /organizations/{organizationId}. If the response contains "customVariables": true pair in the license object then you have access to the custom variables feature.

A successful response contains all information about the updated variable. If you don't have the custom variables feature available then the API call returns the error 404.

Refer to the Make pricing pagearrow-up-right for the Make pricing plans overview.

Update the variable typeId accordingly when you are updating the variable value. Make checks whether the variable type and value match in the request body. There is no check for incorrect variable type when you update only variable value and vice versa.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
variableNamestringRequired

The name of the custom variable.

Example: userID
Body
typeIdnumberOptional

Number representing the type of the custom variable. The mapping of typeId and variable types is as follows:

  • 1: number,
  • 2: string,
  • 3: boolean,
  • 4: datein ISO 8601 compliant format YYYY-MM-DDTHH:mm:ss.sssZ. For example: 1998-03-06T12:31:00.000Z.
valueone ofOptional

Value assigned to the custom variable.

stringOptional
or
booleanOptional
or
numberOptional
or
or
Responses
chevron-right
200

Successful response

application/json
patch
/organizations/{organizationId}/variables/{variableName}
200

Successful response

History of custom variable updates

get
/organizations/{organizationId}/variables/{variableName}/history

Gets the history of updates of the specified custom variable. The response contains the ID value of the variable history entry and a diffObject. The diffObject contains:

  • the original value,

  • the new value,

  • the timestamp of the update,

  • the author of the update.

If the variable doesn't have any updates, the diffObject contains the current value of the variable instead of the original and new values.

The update history entries are sorted from newest to latest.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
variableNamestringRequired

The name of the custom variable.

Example: userID
Responses
chevron-right
200

Successful response

application/json
get
/organizations/{organizationId}/variables/{variableName}/history
200

Successful response

Get organization usage

get
/organizations/{organizationId}/usage

Retrieves a list of daily centicredits, operations, and data transfer usage across all scenarios within all teams in the specified organization for the past 30 days.

By default, the endpoint uses the timezone of the user making the API call to define the start and end of each day in the 30-day timeframe.

To use the organization's timezone instead, set the organizationTimezone parameter to true. This ensures that the daily aggregates align with the organization's operational hours. This is especially useful for scenarios where aggregated data needs to align with the organization's operational hours.

For instance, a remote data analyst in India working for a Czech company can set organizationTimezone=true to ensure the usage data reflects the company's timezone, providing more relevant and accurate insights for organizational reporting and analysis.

For more information on timezones in Make, please refer to our Help Center articlearrow-up-right.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Query parameters
organizationTimezonebooleanOptional

When set to true, the endpoint will calculate and return usage data based on the organization's timezone instead of the user's local timezone.

Example: true
Responses
chevron-right
200

Successfully retrieved usage data

application/json
get
/organizations/{organizationId}/usage
200

Successfully retrieved usage data

Get organization feature controls

get
/organizations/{organizationId}/feature-controls

Retrieves all feature controls for the specified organization. Response order of the feature controls is by descending ID.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
Query parameters
featureControlNamestringOptional

The feature control name.

Example: Make AI Tools
colsstring[]Optional

Specifies columns that are returned in the response. Use the cols[] parameter for every column that you want to return in the response. For example GET /endpoint?cols[]=key1&cols[]=key2 to get both key1 and key2 columns in the response.

Check the "Filtering" section for a full example.

Responses
chevron-right
200

Successfully retrieved feature controls

application/json
get
/organizations/{organizationId}/feature-controls
200

Successfully retrieved feature controls

Patch organization feature controls

patch
/organizations/{organizationId}/feature-controls

Enable or disable feature control for the specified organization.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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
idintegerOptional

The ID of the feature control.

enabledbooleanOptional

Indicates whether the feature control is enabled (true) or disabled (false).

Responses
chevron-right
200

Successful response

application/json
patch
/organizations/{organizationId}/feature-controls
200

Successful response

Check team permission within organization

get
/organizations/{organizationId}/check-team-permission

Checks if the current user has a specific team (company) permission on any team within the specified organization. Returns hasPermission: true if the user has the permission on at least one team in the organization, otherwise returns hasPermission: false.

chevron-right
lockRequired scopes
This endpoint requires the following scopes:
Authorizations
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 to check permissions within.

Example: 123
Query parameters
teamPermissionstringRequired

The name of the team permission to check. This should be a valid company/team permission name (e.g., 'scenario add', 'scenario view', 'team view', 'connection add').

Example: scenario add
Responses
chevron-right
200

Successfully checked permission

application/json
get
/organizations/{organizationId}/check-team-permission

Last updated