Users > User email preferences Mailhub

Get preferences

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

/mailhub/users/{userId}/preferences

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

Responses

200

Successful response

application/json

get

/mailhub/users/{userId}/preferences

HTTPcURLJavaScriptPython

GET /api/v2/mailhub/users/{userId}/preferences HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "preferences": {
    "id": 1,
    "uuid": "e39de7bc-95b0-443c-83e9-ac397ea8f004",
    "email": "[email protected]",
    "is_email_verified": true,
    "global": {
      "isEmailVerified": true,
      "preferences": [
        {
          "id": "use_cases",
          "enabled": false,
          "label": "Use Cases",
          "description": "Get new Make use cases delivered to your inbox."
        },
        {
          "id": "product_updates",
          "enabled": false,
          "label": "Product Updates",
          "description": "Product and feature updates including new releases and important changes."
        },
        {
          "id": "app_updates",
          "enabled": false,
          "label": "App Updates",
          "description": "Get notified about new apps and services as they become available, as well as changes in the existing apps."
        },
        {
          "id": "events_and_webinars",
          "enabled": false,
          "label": "Events and Webinars",
          "description": "Get notified about Make events and webinars including demos, discussions and community events."
        },
        {
          "id": "promotions",
          "enabled": false,
          "label": "Offers and Promotions",
          "description": "Latest promotions and discounts delivered to your inbox."
        },
        {
          "id": "channel_partner_updates",
          "enabled": false,
          "label": "Partnerships",
          "description": "Emails with exclusive information for Make partners such as partner updates and resources."
        },
        {
          "id": "academy",
          "enabled": false,
          "label": "Academy",
          "description": "Receive the latest content from Make Academy including videos, tutorials and educational events."
        },
        {
          "id": "blog",
          "enabled": false,
          "label": "Blog and Newsletter",
          "description": "Get the latest advice, resources and updates on all things Make and no-code automation."
        }
      ]
    },
    "zones": []
  }
}

Update global preferences

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

/mailhub/users/{userId}/preferences

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

Body

application/json

idstringOptional

enabledbooleanOptional

Responses

200

Successful response

application/json

patch

/mailhub/users/{userId}/preferences

HTTPcURLJavaScriptPython

PATCH /api/v2/mailhub/users/{userId}/preferences HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "id": "use_cases",
  "enabled": true
}

200

Successful response

{
  "preferences": {
    "global": {
      "preferences": {
        "id": "use_cases",
        "enabled": true
      }
    }
  }
}

Get team preferences

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

/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences

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

organizationIdstringRequired

teamIdstringRequired

Responses

200

Successful response

application/json

get

/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences

HTTPcURLJavaScriptPython

GET /api/v2/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "id": 3,
  "uuid": "4c090605-19a1-46b9-a3f3-a2cb83e8adc1",
  "email": "[email protected]",
  "is_email_verified": true,
  "team": {
    "teamId": 10,
    "teamName": "My Team",
    "preferences": {
      "native": [
        {
          "id": 6,
          "subscribed": true,
          "label": "Deactivation",
          "description": "Get notified when your scenario gets deactivated due to critical issues such as multiple consecutive errors."
        },
        {
          "id": 2,
          "subscribed": false,
          "label": "Warnings",
          "description": "Warnings encountered by your scenarios that need your attention, such as failure to connect with your apps and services."
        },
        {
          "id": 1,
          "subscribed": true,
          "label": "Errors",
          "description": "Notifications about errors encountered by specific modules in your scenarios that keep your workflows from running smoothly."
        }
      ],
      "marketing": [
        {
          "id": "onboarding",
          "enabled": false,
          "label": "Tips For Success",
          "description": "Organization-specific emails to help you succeed with Make and make the most of your subscription."
        }
      ]
    }
  }
}

Update team preferences

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

/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences

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

organizationIdstringRequired

teamIdstringRequired

Body

application/json

idstringOptional

enabledbooleanOptional

Responses

200

Successful response

application/json

patch

/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences

HTTPcURLJavaScriptPython

PATCH /api/v2/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "id": "onboarding",
  "enabled": true
}

200

Successful response

{
  "team": {
    "preferences": {
      "id": "onboarding",
      "enabled": false
    }
  }
}

Update team native preferences

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

/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/native-preferences

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

organizationIdstringRequired

teamIdstringRequired

Body

application/json

idstring · utc-millisecOptional

enabledbooleanOptional

Responses

200

Successful response

application/json

patch

/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/native-preferences

HTTPcURLJavaScriptPython

PATCH /api/v2/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/native-preferences HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "id": "1",
  "enabled": true
}

200

Successful response

{
  "team": {
    "preferences": {
      "id": "onboarding",
      "enabled": false
    }
  }
}