Sign in

v1

latestOpenAPI 3.0.1Vanta Terms of Service2026-07-26327517821.8 KB
Trust Centers

Send Trust Center update notifications to specific subscribers

Sends notifications for a specific Trust Center update to specific subscribers. At least one subscriber group or email address is required.

The total number of resolved, deduplicated recipient emails must not exceed 5,000. If exceeded, a 422 error is returned. Narrow your filters or split across multiple requests.

post/trust-centers/{slugId}/updates/{updateId}/notify-specific-subscribers

Path parameters

slugIdstring required
updateIdstring required

Request body

emailsstring[] 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.

subscriberGroupIdsstring[] required

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

Example request

{
  "customerTrustAccounts": {
    "customFieldsFilter": [
      {
        "label": "enterprise_id",
        "value": [
          "ent_123",
          "ent_456"
        ]
      }
    ],
    "tagsByCategory": [
      {
        "categoryId": "507f1f77bcf86cd799439011",
        "tagIds": [
          "507f1f77bcf86cd799439012"
        ]
      }
    ]
  }
}

Response

Ok

recipientCountnumber double required

The number of subscribers who will receive this notification.