Skip to main content
PATCH
/
v1
/
tenant
/
{tenant_id}
/
preference
/
category
/
{category}
Update Tenant Preference Single Category
curl --request PATCH \
  --url https://hub.suprsend.com/v1/tenant/{tenant_id}/preference/category/{category}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "preference": "opt_in"
}
'
{
  "name": "tests",
  "category": "tests",
  "description": "asdf",
  "tags": [
    "asdasdasdasderrfjfsdihdaisjaisljdaskjdlkasdlkasdkasdlkasldajsldkajsdaksdasd",
    "checktag"
  ],
  "effective_tags": [
    "asdasdasdasderrfjfsdihdaisjaisljdaskjdlkasdlkasdkasdlkasldajsldkajsdaksdasd",
    "checktag"
  ],
  "root_category": "system",
  "default_preference": "cant_unsubscribe",
  "default_mandatory_channels": null,
  "default_opt_in_channels": null,
  "enabled_for_tenant": true,
  "visible_to_subscriber": true,
  "preference": "opt_in",
  "mandatory_channels": null,
  "opt_in_channels": null,
  "blocked_channels": null,
  "updated_at": "2025-12-06T10:54:46.630096Z"
}

Authorizations

​
Authorization
string
header
required

Pass as Bearer <API_KEY>. Get API Key from SuprSend dashboard Developers -> API Keys section.

Path Parameters

​
tenant_id
string
required

unique identifier of the tenant you want to update preferences for

​
category
string
required

notification category slug. You can get this from Notification Categories page on SuprSend dashboard -> Settings page

Body

application/json
​
preference
enum<string>

set opt_in to turn on notifications on all or selected channels by default, opt_out to turn-off notifications by default, cant_unsubscribe if you do not want users to completely opt-out from this category

Available options:
opt_in,
opt_out,
cant_unsubscribe
​
visible_to_subscriber
boolean

set it false to hide a category from user's preference page

​
mandatory_channels
string[]

Add mandatory channels that the user can't unsubscribe from if preference is cant_unsubscribe.

​
opt_in_channels
string[]

List of channels to opt-in for this category. Only applicable when preference is opt_in.

Response

200

​
name
string
​
category
string
​
description
string | null
​
tags
string[] | null
​
effective_tags
string[] | null
​
root_category
enum<string>
Available options:
system,
transactional,
promotional
​
default_preference
enum<string>
Available options:
opt_in,
opt_out,
cant_unsubscribe
​
default_mandatory_channels
string[] | null
​
default_opt_in_channels
string[] | null
​
enabled_for_tenant
boolean
​
visible_to_subscriber
boolean
​
preference
enum<string> | null
Available options:
opt_in,
opt_out,
cant_unsubscribe
​
mandatory_channels
string[] | null
​
opt_in_channels
string[] | null
​
blocked_channels
string[] | null
​
updated_at
string<date-time> | null