PATCH/v1/suppressions/{id}

Change a suppression entry

The reason, the advertising categories it holds back (empty for all mail) or the note; the address stays.

Scope suppressions.manage

Path parameters

idstringrequired

Body

reasonstringmin length 1max length 60

categoriesarray of stringmax items 50

notestring or null

Returns

12 fields of the 200 answer

idstringrequired

namestringrequired

addressLine1stringrequired

addressLine2string or nullrequired

postalCodestringrequired

citystringrequired

countrystringrequired

reasonstringrequired

categoriesarray of stringrequired

sourceenumrequired

manualcsvapi

notestring or nullrequired

createdAtdate-timerequired

Responses

200Success

401Authentication required or API key invalid

403Permission or scope missing, organisation suspended

404Not found

422Validation failed

429Rate limited for this API key and class; wait Retry-After seconds

otherError (RFC 9457 problem details)

curl -X PATCH https://api.postbuddy.nl/v1/suppressions/sup_01J9Y2K8QF4T6W8Z0B2D4F6H8K \ -H "Authorization: Bearer $POSTBUDDY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "reason": "Example", "categories": [ "Example" ], "note": "Example" }'

import { PostBuddyClient } from '@postbuddy/sdk'; const client = new PostBuddyClient({ apiKey: process.env.POSTBUDDY_API_KEY! }); const result = await client.suppressions.update('sup_01J9Y2K8QF4T6W8Z0B2D4F6H8K', { body: { reason: 'Example', categories: [ 'Example', ], note: 'Example', }, });

import os from postbuddy import Client client = Client(os.environ["POSTBUDDY_API_KEY"]) result = client.suppressions.update("sup_01J9Y2K8QF4T6W8Z0B2D4F6H8K", { "reason": "Example", "categories": [ "Example", ], "note": "Example", })

{ "id": "sup_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "name": "Welcome card", "addressLine1": "Oudegracht 112", "addressLine2": "2nd floor", "postalCode": "3511 AX", "city": "Utrecht", "country": "NL", "reason": "Example", "categories": [ "Example" ], "source": "manual", "note": "Example", "createdAt": "2026-10-16T09:14:02.000Z" }

{ "type": "https://docs.postbuddy.nl/errors/validation_failed", "title": "Validation failed", "status": 422, "code": "validation_failed", "detail": "Validation failed", "requestId": "req_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "errors": [ { "field": "recipient.postalCode", "code": "invalid_string", "message": "Invalid postal code" } ] }