app.suppression_list
TableRow level security on
Addresses an org sends nothing to on a channel (Section 14.5 CAN-SPAM, CASL and TCPA): hard bounces and complaints from the provider, unsubscribes, STOP replies and manual entries. A category limits an unsubscribe to that category.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org. A row never moves to another org.References app.organizations.id |
| channel | app.notification_channel | No | Email or SMS. |
| address | text | No | Lowercased email address or E.164 phone number. |
| reason | app.suppression_reason | No | Why the address is suppressed. |
| category_code | text | Yes | Category the suppression covers, or null for every non-transactional message.References private.notification_categories.code |
| suppressed_at | timestamp with time zone | No | When the suppression began. Set by the database. |
| lifted_at | timestamp with time zone | Yes | When an admin lifted it, for example after a fixed mailbox. |
| created_at | timestamp with time zone | No | When the row was inserted. Set by the database. |
| created_by | uuid | Yes | Person who inserted the row, or null for a platform process. Set by the database.References app.people.id |
| updated_at | timestamp with time zone | No | When the row last changed. Set by the database. |
| updated_by | uuid | Yes | Person who last changed the row, or null for a platform process. Set by the database.References app.people.id |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |