Skip to main content
Changelogs

Remove Changelog subscribers

Removes email addresses from Changelog subscribers in bulk.

DELETE
/v2/outbound/changelogs/subscribers

Removed subscribers no longer receive email notifications when new Changelogs are published.

Request Body

  • emails - Array of email addresses to remove (required, 1-1000 emails)

Email Handling

  • Emails that don't exist as subscribers are silently ignored
  • Emails are normalized (trimmed, lowercased) before matching

Response

Returns a confirmation with the count of processed emails:

{
  "object": "changelog_subscribers_removal",
  "count": 150
}

Errors

  • 400 - Invalid request (empty emails array, too many emails)

Compatibility

Changelogs appear as Updates in the dashboard. Keep using /v2/outbound/changelogs, client.outbound.changelogs, and the changelog.published webhook. This reference describes Pulsar. The original /v2/changelogs routes still work; their behavior follows the selected API version. The Outbound paths require Pulsar or later. In Pulsar, the API key owner needs a full seat and the manage_changelogs permission.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-09-03.pulsar, 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-09-03.pulsar

Body

application/json
emailsstring[]required

Email addresses to remove from changelog subscribers

Required array length: 1 - 1000

Response

application/json

Success

countnumberrequired

Number of email addresses processed

Example: 150
objectenum<string>required

Object type identifier

Available options: changelog_subscribers_removal
Example: changelog_subscribers_removal

Still need help? Ask the team