v30

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-22116135580.0 KB

Users

Preferences

Get user preference set

Retrieves a specific preference set for a user identified by the preference set ID.

get/v1/users/{user_id}/preferences/{id}

Path parameters

user_idstring required

The unique identifier of the user.

idstring required

Example:default

Unique identifier for the preference set.

Query parameters

tenantstring

The unique identifier for the tenant.

Response

commercial_subscribedboolean nullable

Whether the recipient is subscribed to commercial communications. When false, the recipient will not receive commercial workflow notifications.

idstring required

Unique identifier for the preference set.

Example response

{
  "categories": {
    "marketing": false,
    "transactional": {
      "channel_types": {
        "email": false
      }
    }
  },
  "channel_types": {
    "email": true,
    "push": false,
    "sms": {
      "conditions": [
        {
          "argument": "US",
          "operator": "equal_to",
          "variable": "recipient.country_code"
        }
      ]
    }
  },
  "commercial_subscribed": true,
  "id": "default",
  "workflows": null
}