Users > User email preferences Mailhub

Get preferences

get
/mailhub/users/{userId}/preferences
Required 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
userIdstringRequired
Responses
200

Successful response

application/json
get
/mailhub/users/{userId}/preferences
GET /api/v2/mailhub/users/{userId}/preferences HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
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
/mailhub/users/{userId}/preferences
Required 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
userIdstringRequired
Body
idstringOptional
enabledbooleanOptional
Responses
200

Successful response

application/json
patch
/mailhub/users/{userId}/preferences
PATCH /api/v2/mailhub/users/{userId}/preferences HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
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
/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences
Required 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
userIdstringRequired
organizationIdstringRequired
teamIdstringRequired
Responses
200

Successful response

application/json
get
/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences
GET /api/v2/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
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
/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences
Required 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
userIdstringRequired
organizationIdstringRequired
teamIdstringRequired
Body
idstringOptional
enabledbooleanOptional
Responses
200

Successful response

application/json
patch
/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences
PATCH /api/v2/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/preferences HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
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
/mailhub/users/{userId}/organizations/{organizationId}/teams/{teamId}/native-preferences
Required 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
userIdstringRequired
organizationIdstringRequired
teamIdstringRequired
Body
idstring · utc-millisecOptional
enabledbooleanOptional
Responses
200

Successful response

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

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

Successful response

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

Last updated