Users > User team notifications

The following endpoints update and retrieve data about user team notifications settings of a user in a team. Read more about user team notifications.

List user team notification settings

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

/users/{userId}/user-team-notifications/{teamId}

Gets settings for user notifications for a user specified by the userId and a team specified by the teamId. Get the mapping of the notificationId and the team notification setting type with the API call GET /enums/user-email-notifications.

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

userIdintegerRequired

The ID of the user.

Example: 3

teamIdintegerRequired

The ID of the team.

Example: 3

Responses

200

Successful response

application/json

get

/users/{userId}/user-team-notifications/{teamId}

HTTPcURLJavaScriptPython

GET /api/v2/users/{userId}/user-team-notifications/{teamId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "userTeamNotifications": [
    {
      "userId": 3,
      "teamId": 3,
      "notificationId": 1,
      "enabled": true
    },
    {
      "userId": 3,
      "teamId": 3,
      "notificationId": 2,
      "enabled": false
    },
    {
      "userId": 3,
      "teamId": 3,
      "notificationId": 6,
      "enabled": true
    }
  ]
}

Check user's notification settings

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

/users/{userId}/user-team-notifications/{teamId}/{notificationId}

Checks team notification settings for specific user, team and notification type with the specified userId, teamId and notificationId. Get the mapping of the notificationId and the team notification setting type with the API call GET /enums/user-email-notifications.

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

userIdintegerRequired

The ID of the user.

Example: 1

teamIdintegerRequired

The ID of the team.

Example: 1

notificationIdintegerRequired

The ID of the notification type. Get the mapping of the notificationId and the team notification setting type with the API call GET /enums/user-email-notifications.

Example: 6

Responses

200

Successful response

application/json

get

/users/{userId}/user-team-notifications/{teamId}/{notificationId}

HTTPcURLJavaScriptPython

GET /api/v2/users/{userId}/user-team-notifications/{teamId}/{notificationId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "userTeamNotification": {
    "userId": 1,
    "teamId": 1,
    "notificationId": 6,
    "enabled": true
  }
}

Update user's notification settings

put

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

/users/{userId}/user-team-notifications/{teamId}/{notificationId}

Updates team notification settings for the user identified with the userId, teamId and notificationId.

Get the mapping of the notificationId and the team notification setting type with the API call GET /enums/user-email-notifications.

Note that you can only update notification settings for the user associated with the API key used for authentication.

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

userIdstringRequired

The ID of the user.

Example: 1

teamIdstringRequired

The ID of the team.

Example: 1

notificationIdstringRequired

The ID of the notification type. Get the mapping of the notificationId and the team notification setting type with the API call GET /enums/user-email-notifications.

Example: 6

Body

application/json

enabledbooleanOptional

Enables or disables team notification type for the user.

Responses

200

Successful response

application/json

put

/users/{userId}/user-team-notifications/{teamId}/{notificationId}

HTTPcURLJavaScriptPython

PUT /api/v2/users/{userId}/user-team-notifications/{teamId}/{notificationId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "enabled": true
}

200

Successful response

{
  "userTeamNotification": {
    "userId": 1,
    "teamId": 1,
    "notificationId": 6,
    "enabled": true
  }
}