Skip to main content
POST
/
trust-centers
/
{slugId}
/
updates
/
{updateId}
/
notify-specific-subscribers
Send Trust Center update notifications to specific subscribers
curl --request POST \
  --url https://api.vanta.com/v1/trust-centers/{slugId}/updates/{updateId}/notify-specific-subscribers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emails": [
    "<string>"
  ],
  "subscriberGroupIds": [
    "<string>"
  ],
  "customerTrustAccounts": {
    "customFieldsFilter": [
      {
        "label": "enterprise_id",
        "value": [
          "ent_123",
          "ent_456"
        ]
      }
    ],
    "tagsByCategory": [
      {
        "categoryId": "507f1f77bcf86cd799439011",
        "tagIds": [
          "507f1f77bcf86cd799439012"
        ]
      }
    ]
  }
}
'
{
  "recipientCount": 5
}

Documentation Index

Fetch the complete documentation index at: https://vanta.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
slugId
string
required
​
updateId
string
required

Body

application/json

Input for sending notifications to specific subscribers of a Trust Center update.

Recipient limit: The total number of deduplicated recipient emails resolved from subscriber groups, account filters, and additional emails must not exceed 5,000. If the resolved recipient count exceeds this limit, the request will return a 422 error. To notify more recipients, narrow your filters or split across multiple requests.

​
emails
string[]
required

Additional email addresses to notify about this Trust Center update in addition to the existing Trust Center subscribers. Duplicate emails are deduplicated to ensure each recipient gets only one notification.

Maximum array length: 10
​
subscriberGroupIds
string[]
required

IDs of subscriber groups to notify. When customerTrustAccounts is also provided, only subscribers in these groups whose linked account matches are notified.

Maximum array length: 10
​
customerTrustAccounts
object

Optional account filters. When provided, only subscribers in subscriberGroupIds whose linked account matches all specified filters are notified.

Response

200 - application/json

Ok

​
recipientCount
number<double>
required

The number of subscribers who will receive this notification.