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

token

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.

Possible values:

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

200

Successful response

application/json

get

HTTPcURLJavaScriptPython

GET /api/v2/admin/teams?organizationId=1 HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "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
  }
}

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

token

Body

application/json

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

200

Successful response

application/json

post

HTTPcURLJavaScriptPython

POST /api/v2/admin/teams HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "name": "Marketing team",
  "organizationId": 20,
  "userTeamAdmin": 15
}

200

Successful response

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

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

token

Path parameters

teamIdintegerRequired

The ID of the team.

Example: 22

Responses

200

Successful response

application/json

delete

HTTPcURLJavaScriptPython

DELETE /api/v2/admin/teams/{teamId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "team": 22
}

Update team

patch

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

Authorizations

token

Path parameters

teamIdintegerRequired

The ID of the team.

Example: 56

Body

application/json

namestringOptional

The name of the team.

Responses

200

Successful response

application/json

patch

HTTPcURLJavaScriptPython

PATCH /api/v2/admin/teams/{teamId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "name": "Sales people team"
}

200

Successful response

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