Skip to main content
GET

List Suppressions

GET /v1/sms/suppressions

Query Parameters

string
Filter suppressions to a specific phone number. If omitted, returns all org-wide suppressions. Format: pn_...

Response

SmsSuppression[]
Array of active suppressions.

Remove Suppression

DELETE /v1/sms/suppressions/{phoneNumber} Removes the suppression for a phone number, re-enabling outbound messages to it.

Path Parameters

string
required
The external phone number to un-suppress, URL-encoded. Example: %2B14155559999 (for +14155559999).

Response

object
Automatic suppression: Commune automatically suppresses a number when an inbound STOP (or STOPALL, UNSUBSCRIBE, CANCEL, END, QUIT) is received. Suppressed numbers have their inbound messages discarded and outbound sends return 422 recipient_suppressed.Suppression is automatically lifted when an inbound START, YES, or UNSTOP is received — you do not need to call this endpoint for that case. Use this endpoint only to manually remove suppressions.
Scope: Suppressions can be per-phone-number (phoneNumberId set) or org-wide (phoneNumberId null). An org-wide suppression blocks delivery from all of your phone numbers to that contact.
Last modified on March 19, 2026