Consent modes
Universal opt-out
An opt-out received on any channel blocks marketing outreach to the linked contact on voice, SMS, email, and supported messaging channels. Universal mode is the conservative default and remains available on every plan.Per-channel opt-out
An opt-out applies only to the originating channel. For example, an SMS opt-out blocks SMS marketing while independent voice or email consent can remain usable. Per-channel mode requires the Consent & Compliance plan feature. If that feature is unavailable, the workspace remains in universal mode; suppression enforcement is never disabled.Changing the workspace mode does not rewrite earlier opt-outs. The rule that applied when the contact opted out remains visible in the audit history.
Suppression records
An active record can be linked to a contact, phone number, or email address. It shows the affected channels, where the request was received, its reason, and when it was created. Listing with achannel filter returns both that channel’s records and
universal (all) records, because both block outreach on the requested
channel.
Restoring consent
Restoring consent does not erase compliance history. The active suppression is revoked and an opt-in event is appended to the audit trail. Use the suppression record ID whenever possible. The API also accepts a URL-encoded E.164 phone number or email address.Legal grounding for outreach
This section is general information, not legal advice. Marketing and telemarketing rules vary by country and channel — confirm your specific case with legal counsel before launching a campaign.
Practical baseline regardless of region: keep a documented basis for each contact (consent record, existing relationship, or legitimate interest), make opting out easy and immediate, and keep the audit trail suppression records already provide. Pair this with your workspace’s data retention settings so contact and consent records aren’t kept longer than needed. For outbound calling specifically, see Dialer, retries & compliance.
AI disclosure requirement
Since August 2026, the EU AI Act’s transparency obligation (Art. 50) requires that people be told when they’re interacting with AI — for example an AI voice assistant on a call — unless it’s obvious from context. A short, clear line is enough, such as telling the caller up front that they’re speaking with an AI assistant.REST API
Read or update the workspace mode:contact_id, phone, or email.
When channel is omitted, phone defaults to voice and email defaults to
email. Use GET /api/v1/suppression-list?channel=sms to list records that
block SMS. Restore one record with
DELETE /api/v1/suppression-list/{id-or-identity}.
REST scopes are settings:read / settings:write for the mode and
suppression:read / suppression:write for records.
MCP
get_consent_modeandset_consent_mode;list_suppression_entries;add_suppression_entry;remove_suppression_entry(restores consent and retains the audit trail).