Admin > Teams

The following endpoint allows you to create new teams within organizations in the Make White Label product. You can set the team admin directly in the API call request body.

List teams

get

Gets the list of teams in the organization with the specified organizationId.

Authorizations

Query parameters

organizationIdintegerrequired

The ID of the organization.

Example: 22

externalIdstringoptional

Custom team ID from an external system to the Make White Label platform.

pg[sortBy]string · enumoptional

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

Available options:

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.

Available options:

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

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/admin/teams?organizationId=1' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "teams": [
    {
      "id": 38,
      "name": "Management",
      "organizationId": 22,
      "scenarioDrafts": false,
      "deleted": false,
      "externalId": null
    },
    {
      "id": 36,
      "name": "Removed team",
      "organizationId": 20,
      "scenarioDrafts": false,
      "deleted": true,
      "externalId": null
    }
  ],
  "pg": {
    "sortBy": "name",
    "limit": 10000,
    "sortDir": "asc",
    "offset": 0
  }
}

Successful response

Create a team

post

Creates a new team in the specified organization.

You can set the team admin with the parameter userTeamAdmin in the request body. If you don't use the userTeamAdmin parameter and you are part of the organization, then Make sets you as the team admin.

Authorizations

Body

namestringrequired

The name of the team.

organizationIdintegerrequired

The ID of the organization.

userTeamAdminintegeroptional

Set the user with the specified userId as the admin of the team.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://eu1.make.com/api/v2/admin/teams' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Marketing team",
    "organizationId": 20,
    "userTeamAdmin": 15
  }'

200

200

{
  "team": {
    "id": 26,
    "name": "Marketing team",
    "organizationId": 20
  },
  "userTeamRole": {
    "usersRoleId": 1,
    "userId": 15,
    "teamId": 26,
    "changeable": false,
    "ssoPending": false
  }
}

Successful response

Delete a team

delete

Deletes the team with the specified teamId. Make removes all users from the deleted team and deletes all data associated with the team, such as data stores and scenarios.

The team won't be visible for the users. However, if you run the API call GET /admin/teams the response will contain also the deleted team with the deleted: true pair. Similarly, the team will remain visible in the Administration UI.

Authorizations

Path parameters

teamIdintegerrequired

The ID of the team.

Example: 22

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://eu1.make.com/api/v2/admin/teams/{teamId}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "team": 22
}

Successful response

Update team

patch

Updates team information. Make updates only the values in the request body.

Authorizations

Path parameters

teamIdintegerrequired

The ID of the team.

Example: 56

Body

namestringoptional

The name of the team.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'https://eu1.make.com/api/v2/admin/teams/{teamId}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Sales people team"
  }'

200

200

{
  "id": 56,
  "name": "Sales people team",
  "organizationId": 22,
  "scenarioDrafts": false,
  "deleted": false,
  "externalId": null
}

Successful response