A Suppression records that Custral must not send to a particular address again. Suppressions are workspace-scoped, per-channel-type, and outweigh any subsequent send attempt: even a manual one.
Every outbound send checks the suppression list first. If the recipient is suppressed for that channel type, the send is stopped and the failure is recorded on the Conversation timeline as suppressed. This applies to manual sends, sequences, and workflow actions equally.
A user with admin permission can remove a suppression from the Channels settings page. Removing a suppression added by complaint is rarely safe, the recipient explicitly flagged you as spam.
Removing an unsubscribe suppression so you can re-mail someone is, in many jurisdictions, a regulatory violation
(GDPR, CAN-SPAM). Be sure you have a valid reason to override the user’s choice.
Suppressions are scoped to channel type (email, sms), not individual channels. An email address suppressed via Mailbox A is also suppressed when sending from Mailbox B. This prevents a contact who unsubscribed from one of your sender personas from receiving mail from another.
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Custral Docs","colors":{"primary":"#5E7CFF","light":"#5E7CFF","dark":"#5E7CFF"},"logo":{"light":"https://mintcdn.com/custral/9h_119tROzHTKUiS/assets/logos/light.svg?fit=max\u0026auto=format\u0026n=9h_119tROzHTKUiS\u0026q=85\u0026s=50b063929ddff7335cc4db8352ae694a","dark":"https://mintcdn.com/custral/9h_119tROzHTKUiS/assets/logos/dark.svg?fit=max\u0026auto=format\u0026n=9h_119tROzHTKUiS\u0026q=85\u0026s=4025f09bcbe60697aef60a5bb3f849f0"},"favicon":"https://mintcdn.com/custral/NGCdls_pt-1YDx5S/favicon.svg?fit=max\u0026auto=format\u0026n=NGCdls_pt-1YDx5S\u0026q=85\u0026s=3a0ce3e846a625e7bc5e70aafe82cffa","navbar":{"links":[{"href":"https://custral.com","label":"Get Started"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.custral.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/custral"},"links":[{"header":"Resources","items":[{"label":"Status Page","href":"https://status.custral.com"},{"label":"Blog","href":"https://blog.custral.com"}]},{"header":"Support","items":[{"label":"Get support","href":"/support"},{"label":"hello@custral.com","href":"mailto:hello@custral.com"}]}]},"search":{"prompt":"Search Custral docs..."},"seo":{"metatags":{"og:image":"/images/og-docs.png","og:image:width":"2400","og:image:height":"1260","twitter:card":"summary_large_image","twitter:image":"/images/og-docs.png"}},"banner":{"content":"New: Focus Mode sorts your inbox, records open in a peek, a rebuilt mobile app, and a daily brief. [See what's new](/product/updates)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"custral","hasAudioNarration":false,"actualSubdomain":"custral","customDomains":["docs.custral.com"],"gitSource":{"type":"github","owner":"custral","repo":"custral-mono","deployBranch":"master","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ade1ad5cc4d8fc7f4e59b84","collectionId":"a149e1a3-54d3-4769-89c2-5031be517fb3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ade1ad5cc4d8fc7f4e59b84"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae601488b8badc2e429ed75","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Documentation","count":317},{"language":"default","tag":"Developer References","count":108},{"language":"default","tag":"Communications","count":66},{"language":"default","tag":"Data Structures","count":60},{"language":"default","tag":"API Reference","count":56},{"language":"default","tag":"Endpoints","count":49},{"language":"default","tag":"Blocks","count":46},{"language":"default","tag":"Properties","count":40},{"language":"default","tag":"Getting Started","count":37},{"language":"default","tag":"Embedded Components","count":35}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".cxh{--brand:#5E7CFF;--brand-ink:#3f57e6;--brand-soft:#eef1ff;--g1:#5E7CFF;--g2:#8b5cf6;--g3:#ff5f7a;--bg:#ffffff;--bg2:#fbfbfe;--card:#ffffff;--panel:#f6f7fb;--border:#e8e9f3;--border-soft:#f0f1f8;--text:#191b26;--muted:#5b5e73;--faint:#9a9db2;--code-bg:#0f1119;--code-text:#e7e9f5;--a1:#5E7CFF;--a2:#8b5cf6;--a3:#ff5f7a;--a4:#10b981;--k:#c4b5fd;--s:#86efac;--f:#93c5fd;--c:#6b7089;--p:#f0a4b8;--shadow-sm:0 1px 2px rgba(20,22,50,.05),0 3px 10px rgba(20,22,50,.05);--shadow-lg:0 2px 6px rgba(20,22,50,.06),0 20px 50px rgba(30,34,80,.13);--dot:rgba(94,124,255,.14);--radius:14px;--mono:ui-monospace,SFMono-Regular,\"SF Mono\",Menlo,Consolas,monospace;color:var(--text)}:root[data-theme=dark] .cxh,html.dark .cxh,html[data-theme=dark] .cxh{--brand:#7d90ff;--brand-ink:#a6b2ff;--brand-soft:#191c2e;--bg:#0c0d14;--bg2:#0a0b11;--card:#14161f;--panel:#111219;--border:#242738;--border-soft:#1b1e29;--text:#e9eaf2;--muted:#a0a3b8;--faint:#6f7288;--code-bg:#0a0b12;--code-text:#e7e9f5;--shadow-sm:0 1px 2px rgba(0,0,0,.4),0 3px 10px rgba(0,0,0,.35);--shadow-lg:0 2px 6px rgba(0,0,0,.5),0 24px 60px rgba(0,0,0,.6);--dot:rgba(125,144,255,.14)}.cxh *{box-sizing:border-box}.cxh a{color:inherit;text-decoration:none}.cxh .wrap{max-width:1120px;margin:0 auto;padding-inline:28px}.cxh .fullbleed{width:100%}.cxh .hero{position:relative;overflow:hidden;border-bottom:1px solid var(--border-soft);background:var(--bg)}.cxh .hero-bg,.cxh .hero-dots{position:absolute;inset:0;z-index:0}.cxh .hero-bg{background:radial-gradient(680px 360px at 80% -10%,color-mix(in srgb,var(--brand) 22%,transparent),transparent 70%),radial-gradient(560px 300px at 6% 0%,color-mix(in srgb,var(--g2) 13%,transparent),transparent 70%)}.cxh .hero-dots{opacity:.9;background-image:radial-gradient(var(--dot) 1px,transparent 1.4px);background-size:22px 22px;mask-image:linear-gradient(180deg,#000,transparent 80%);-webkit-mask-image:linear-gradient(180deg,#000,transparent 80%)}.cxh .hero-in{position:relative;z-index:1;display:grid;grid-template-columns:1fr 1fr;gap:48px;align-items:center;padding:66px 0 60px}.cxh .eyebrow{font-size:12px;font-weight:700;letter-spacing:.14em;text-transform:uppercase;color:var(--brand-ink)}.cxh h1{font-size:46px;line-height:1.04;letter-spacing:-.03em;margin:14px 0 0;font-weight:750;text-wrap:balance;color:var(--text)}.cxh .lead{font-size:17.5px;line-height:1.55;color:var(--muted);margin:18px 0 0;max-width:34ch}.cxh .cta{display:flex;align-items:center;gap:12px;margin-top:28px;flex-wrap:wrap}.cxh .btn{display:inline-flex;align-items:center;gap:7px;height:40px;padding:0 18px;border-radius:9px;font-size:14px;font-weight:600;border:1px solid transparent;cursor:pointer}.cxh .btn.primary{background:var(--brand);color:#fff;box-shadow:0 1px 2px rgba(63,87,230,.35)}.cxh .btn.ghost{background:0 0;color:var(--text);border-color:var(--border)}.cxh .btn.ghost:hover{border-color:color-mix(in srgb,var(--brand) 45%,var(--border))}.cxh .cta .clink{font-size:14px;font-weight:600;color:var(--brand-ink);display:inline-flex;align-items:center;gap:6px}.cxh .herovis{position:relative;padding:6px 8px 26px 0}.cxh .appwin{position:relative;z-index:1;background:var(--card);border:1px solid var(--border);border-radius:14px;box-shadow:var(--shadow-lg);overflow:hidden;transform:rotate(-.6deg)}.cxh .winbar{display:flex;align-items:center;gap:7px;padding:9px 13px;border-bottom:1px solid var(--border-soft);background:var(--panel)}.cxh .tl{width:10px;height:10px;border-radius:50%}.cxh .tl.r{background:#ff5f57}.cxh .tl.y{background:#febc2e}.cxh .tl.g{background:#28c840}.cxh .winbar .wt{margin-left:8px;font-size:12px;font-weight:600;color:var(--muted)}.cxh .winbar .wpill{margin-left:auto;font-size:10.5px;color:var(--brand-ink);background:var(--brand-soft);border-radius:20px;padding:2px 8px;font-weight:600}.cxh .winbody{display:flex;min-height:214px}.cxh .side,.cxh .tcol ul{display:flex;flex-direction:column;gap:2px}.cxh .side{flex:0 0 120px;background:var(--bg2);border-right:1px solid var(--border-soft);padding:10px 8px}.cxh .snav{display:flex;align-items:center;gap:8px;font-size:12px;color:var(--muted);padding:6px 8px;border-radius:7px;font-weight:500}.cxh .snav .g{width:15px;text-align:center;opacity:.85}.cxh .snav.on{background:var(--brand-soft);color:var(--brand-ink);font-weight:600}.cxh .main{flex:1;padding:6px 4px}.cxh .conv{display:flex;align-items:center;gap:10px;padding:9px 12px;border-radius:9px}.cxh .conv+.conv{border-top:1px solid var(--border-soft)}.cxh .conv .av{flex:0 0 auto;width:28px;height:28px;border-radius:50%;display:grid;place-items:center;color:#fff;font-size:11px;font-weight:700}.cxh .conv .av.a1{background:var(--a1)}.cxh .conv .av.a2{background:var(--a2)}.cxh .conv .av.a3{background:var(--a3)}.cxh .conv .av.a4{background:var(--a4)}.cxh .conv .ct{min-width:0;flex:1}.cxh .conv .cn{font-size:12.5px;font-weight:600;display:flex;align-items:center;gap:6px;color:var(--text)}.cxh .conv .ch{font-size:9.5px;font-weight:700;letter-spacing:.04em;text-transform:uppercase;color:var(--faint);border:1px solid var(--border);border-radius:5px;padding:0 4px}.cxh .conv .cs{display:block;font-size:11.5px;color:var(--muted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;margin-top:1px}.cxh .conv .cd{flex:0 0 auto;font-size:10.5px;color:var(--faint)}.cxh .conv .un{width:7px;height:7px;border-radius:50%;background:var(--brand);flex:0 0 auto}.cxh .codecard{position:absolute;z-index:2;right:-6px;bottom:-6px;width:290px;border-radius:12px;background:var(--code-bg);box-shadow:var(--shadow-lg);border:1px solid rgba(255,255,255,.07);overflow:hidden;transform:rotate(2.2deg)}.cxh .codebar{display:flex;align-items:center;gap:6px;padding:8px 11px;border-bottom:1px solid rgba(255,255,255,.07)}.cxh .codebar .tl{width:9px;height:9px}.cxh .codebar .name{margin-left:6px;font:11px/1 var(--mono);color:#8b8fa8}.cxh pre.code{margin:0;white-space:pre;text-align:left;padding:12px 13px 14px;font:11px/1.65 var(--mono);color:var(--code-text);overflow:hidden;background:0 0;border:0}.cxh .k{color:var(--k)}.cxh .s{color:var(--s)}.cxh .f{color:var(--f)}.cxh .c{color:var(--c)}.cxh .p{color:var(--p)}.cxh section{padding-block:56px}.cxh .pathsec{padding-block:48px 8px}.cxh .tasksec{padding-top:40px}.cxh .sechead{display:flex;align-items:baseline;justify-content:space-between;gap:16px;margin-bottom:26px}.cxh .path h4,.cxh h2{font-size:22px;letter-spacing:-.02em;font-weight:700;color:var(--text)}.cxh .path p,.cxh .sechead .sub{font-size:13.5px;color:var(--faint)}.cxh .paths{display:grid;grid-template-columns:1fr 1fr;gap:16px}.cxh .path{display:flex;gap:14px;align-items:flex-start;background:var(--card);border:1px solid var(--border);border-radius:var(--radius);padding:18px 20px;box-shadow:var(--shadow-sm)}.cxh .path:hover{border-color:color-mix(in srgb,var(--brand) 45%,var(--border))}.cxh .path .pic,.cxh .tcol h3 .ic{background:var(--brand-soft);display:grid;place-items:center}.cxh .path .pic{flex:0 0 auto;width:38px;height:38px;border-radius:10px;color:var(--brand-ink);font-size:17px}.cxh .path h4{margin:2px 0 4px;font-size:15.5px;font-weight:650;letter-spacing:-.01em}.cxh .path p{margin:0;color:var(--muted);line-height:1.5}.cxh .path .go{margin-top:10px;font-size:13px;font-weight:600;display:inline-flex;gap:6px}.cxh .tasks{display:grid;grid-template-columns:repeat(3,1fr);gap:34px}.cxh .tcol h3,.cxh .tcol li a{display:flex;align-items:center}.cxh .tcol h3{font-size:12.5px;font-weight:700;letter-spacing:.06em;text-transform:uppercase;color:var(--faint);margin:0 0 14px;gap:8px}.cxh .tcol h3 .ic{width:22px;height:22px;border-radius:6px;font-size:11px}.cxh .tcol ul{list-style:none;margin:0;padding:0}.cxh .tcol li,.cxh h2{margin:0}.cxh .tcol li a{gap:9px;padding:7px 9px;margin:0 -9px;border-radius:8px;font-size:14px;color:var(--text);font-weight:450}.cxh .dgroup h3 .chip,.cxh .path .go,.cxh .tcol h3 .ic,.cxh .tcol li a:hover{color:var(--brand-ink)}.cxh .tcol li a .arw{color:var(--faint);font-size:12px;margin-left:auto;opacity:0;transition:.15s}.cxh .tcol li a:hover .arw{opacity:1}.cxh .dirwrap{background:var(--bg2);border-top:1px solid var(--border-soft);border-bottom:1px solid var(--border-soft)}.cxh .dir{display:grid;grid-template-columns:repeat(2,1fr);gap:14px 40px}.cxh .dgroup{padding:4px 0}.cxh .dgroup h3{gap:10px;font-size:14px;font-weight:700;margin:0 0 12px;letter-spacing:-.01em}.cxh .dgroup h3 .chip{width:26px;height:26px;border-radius:8px;display:grid;place-items:center;font-size:13px;background:var(--brand-soft)}.cxh .drow{display:flex;gap:12px;padding:9px 10px;margin:0 -10px;border-radius:10px;align-items:flex-start}.cxh .drow:hover,.cxh .tcol li a:hover{background:var(--panel)}.cxh .drow .di,.cxh .helprow a{font-size:13px;color:var(--muted)}.cxh .drow .di{flex:0 0 auto;width:30px;height:30px;border-radius:8px;border:1px solid var(--border);background:var(--card);display:grid;place-items:center;margin-top:1px}.cxh .drow .dt{font-size:14px;font-weight:600;letter-spacing:-.01em;color:var(--text)}.cxh .drow .dd{font-size:12.5px;color:var(--muted);line-height:1.45;margin-top:1px}.cxh .dgroup h3,.cxh .helprow{display:flex;align-items:center}.cxh .helprow{flex-wrap:wrap;gap:14px 22px;padding:26px 0 8px}.cxh .helprow a{font-weight:500}.cxh .dgroup h3,.cxh .helprow a:hover{color:var(--text)}.cxh .helprow .sep{color:var(--faint)}.cxh .helprow .lead-in{font-size:13px;color:var(--faint);margin-right:6px}.cxh .supportband{background:var(--bg2);border-top:1px solid var(--border);border-bottom:1px solid var(--border);margin-top:40px}.cxh .supportrow{display:grid;grid-template-columns:1fr auto;gap:32px;align-items:center;padding:34px 0}.cxh .supportrow h3{font-size:19px;font-weight:650;letter-spacing:-.01em;margin:0 0 6px}.cxh .supportrow p{font-size:14px;color:var(--muted);margin:0 0 12px;max-width:44ch}.cxh .supportcontacts{display:flex;gap:10px;flex-wrap:wrap}.cxh .scontact{display:flex;align-items:center;gap:11px;padding:12px 16px;border:1px solid var(--border);border-radius:11px;background:var(--bg);min-width:236px;transition:border-color .15s ease}.cxh .scontact:hover{border-color:var(--brand)}.cxh .scontact .si{width:30px;height:30px;flex:none;display:flex;align-items:center;justify-content:center;border-radius:8px;background:var(--brand-soft);color:var(--brand-ink);font-size:14px}.cxh .scontact .sl{display:block;font-size:11.5px;color:var(--faint);letter-spacing:.01em}.cxh .scontact .sv{display:block;font-size:14px;font-weight:600;color:var(--text)}@media (max-width:920px){.cxh .hero-in{grid-template-columns:1fr;gap:44px;padding:48px 0 56px}.cxh .herovis{padding:0 8px 20px 0;max-width:520px}.cxh .tasks{gap:26px}.cxh .paths,.cxh .tasks{grid-template-columns:1fr}.cxh .dir,.cxh .supportrow{grid-template-columns:1fr;gap:8px 0}.cxh h1{font-size:36px}.cxh .supportrow{gap:22px}.cxh .scontact{min-width:0;flex:1 1 100%}}.nav-tag-pill-text[data-nav-tag=OBJECT]{color:rgb(82 82 91);background:rgb(113 113 122/.14);font-size:.5rem;white-space:nowrap}.dark .nav-tag-pill-text[data-nav-tag=OBJECT]{color:rgb(161 161 170);background:rgb(161 161 170/.16)}div:has(>.nav-tag-pill>[data-nav-tag=OBJECT]){order:-1;width:2rem;margin-right:6px;overflow:visible}.update-container>div:first-child>div.break-words{display:none}.card-group .card>img.object-cover{aspect-ratio:16/10;height:auto;object-position:top center}"}],"page":{"pagePath":"comms/suppressions/overview","slug":"/comms/suppressions/overview","pageMetadata":{"title":"Suppressions","sidebarTitle":"Overview","description":"Bounce, complaint, and unsubscribe handling.","icon":"ban","href":"/comms/suppressions/overview"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Bounce, complaint, and unsubscribe handling.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`Suppression`}),` records that Custral must not send to a particular address again. Suppressions are workspace-scoped, per-channel-type, and outweigh any subsequent send attempt: even a manual one.`]}),`\n`,_jsx(Heading,{level:`2`,id:`sources-of-a-suppression`,children:`Sources of a suppression`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Source`}),_jsx(_components.th,{children:`Trigger`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Hard bounce`})}),_jsx(_components.td,{children:`The receiving mailbox permanently rejects the message (mailbox not found, domain does not exist).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Soft bounce, repeated`})}),_jsx(_components.td,{children:`Three or more consecutive soft bounces (mailbox full, temporarily unavailable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Complaint`})}),_jsx(_components.td,{children:`The recipient marks a message as spam and the provider reports the complaint back to Custral.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Unsubscribe`})}),_jsxs(_components.td,{children:[`The recipient clicks the unsubscribe link or replies `,_jsx(_components.code,{children:`STOP`}),` (SMS).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Manual`})}),_jsx(_components.td,{children:`A user adds the address from the Channel settings page or the API.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`lookup-before-send`,children:`Lookup before send`}),`\n`,_jsx(_components.p,{children:`Every outbound send checks the suppression list first. If the recipient is suppressed for that channel type, the send is stopped and the failure is recorded on the Conversation timeline as suppressed. This applies to manual sends, sequences, and workflow actions equally.`}),`\n`,_jsx(Heading,{level:`2`,id:`removing-a-suppression`,children:`Removing a suppression`}),`\n`,_jsxs(_components.p,{children:[`A user with admin permission can remove a suppression from the Channels settings page. Removing a suppression added by `,_jsx(_components.strong,{children:`complaint`}),` is rarely safe, the recipient explicitly flagged you as spam.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Removing an unsubscribe suppression so you can re-mail someone is, in many jurisdictions, a regulatory violation\n(GDPR, CAN-SPAM). Be sure you have a valid reason to override the user’s choice.`})}),`\n`,_jsx(Heading,{level:`2`,id:`per-channel-type-vs-per-channel`,children:`Per-channel-type vs per-channel`}),`\n`,_jsxs(_components.p,{children:[`Suppressions are scoped to channel `,_jsx(_components.strong,{children:`type`}),` (`,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`sms`}),`), not individual channels. An email address suppressed via Mailbox A is also suppressed when sending from Mailbox B. This prevents a contact who unsubscribed from one of your sender personas from receiving mail from another.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Suppressions","sidebarTitle":"Overview","description":"Bounce, complaint, and unsubscribe handling.","icon":"ban","href":"/comms/suppressions/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Sources of a suppression","slug":"sources-of-a-suppression","depth":2,"children":[]},{"title":"Lookup before send","slug":"lookup-before-send","depth":2,"children":[]},{"title":"Removing a suppression","slug":"removing-a-suppression","depth":2,"children":[]},{"title":"Per-channel-type vs per-channel","slug":"per-channel-type-vs-per-channel","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/custral/17880bab12267dd5/index.js"],"subdomain":"custral","siteName":"Custral Docs","title":"Suppressions - Custral Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-13T19:13:55.023Z","originalFileLocation":"comms/suppressions/overview.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Bounce, complaint, and unsubscribe handling.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Custral Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Suppressions - Custral Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Bounce, complaint, and unsubscribe handling.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Custral Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.custral.com/comms/suppressions/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://custral.mintlify.app/images/og-docs.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Suppressions - Custral Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Bounce, complaint, and unsubscribe handling.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://custral.mintlify.app/images/og-docs.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Custral Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5E7CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.custral.com/comms/suppressions/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/comms/suppressions/overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.custral.com/#organization\",\"name\":\"Custral Docs\",\"url\":\"https://docs.custral.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/custral/9h_119tROzHTKUiS/assets/logos/light.svg?fit=max\u0026auto=format\u0026n=9h_119tROzHTKUiS\u0026q=85\u0026s=50b063929ddff7335cc4db8352ae694a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.custral.com#website\",\"name\":\"Custral Docs\",\"url\":\"https://docs.custral.com\",\"publisher\":{\"@id\":\"https://docs.custral.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.custral.com/comms/suppressions/overview#webpage\",\"url\":\"https://docs.custral.com/comms/suppressions/overview\",\"name\":\"Suppressions\",\"description\":\"Bounce, complaint, and unsubscribe handling.\",\"dateModified\":\"2026-09-13T19:13:55.023Z\",\"isPartOf\":{\"@id\":\"https://docs.custral.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.custral.com/comms/suppressions/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.custral.com/comms/suppressions/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Deliverability\",\"item\":\"https://docs.custral.com/comms/deliverability/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Suppressions\",\"item\":\"https://docs.custral.com/comms/suppressions/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.custral.com/comms/suppressions/overview#article\",\"headline\":\"Suppressions\",\"name\":\"Suppressions\",\"description\":\"Bounce, complaint, and unsubscribe handling.\",\"url\":\"https://docs.custral.com/comms/suppressions/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.custral.com/comms/suppressions/overview#webpage\"},\"image\":\"https://docs.custral.com/images/og-docs.png\",\"dateModified\":\"2026-09-13T19:13:55.023Z\",\"publisher\":{\"@id\":\"https://docs.custral.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.custral.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Custral Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Custral Docs","nav":{"global":null,"products":[{"product":"Documentation","icon":"book-open","tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":"/start/introduction"}]},{"tab":"AI","pages":[{"title":"AI","href":"/ai/overview"}]},{"tab":"Communications","groups":[{"group":"Overview","pages":[{"title":"Communications","sidebarTitle":"Overview","icon":"messages","mode":"wide","href":"/comms/overview"}]},{"group":"Email","pages":[{"title":"Email","sidebarTitle":"Overview","icon":"envelope","mode":"wide","href":"/comms/email/overview"},{"title":"Get started with Email","icon":"rocket","href":"/comms/email/getting-started"},{"title":"Compose \u0026 Send","icon":"paper-plane","href":"/comms/email/compose"},{"title":"Composer Commands","icon":"slash","href":"/comms/email/commands"},{"title":"Smart Compose","icon":"wand-magic-sparkles","href":"/comms/email/smart-compose"},{"title":"AI Writing Assistance","icon":"wand-magic-sparkles","href":"/comms/email/ai-assist"},{"title":"Email snippets","icon":"file-lines","href":"/comms/email/templates"},{"title":"Scheduling","icon":"clock","href":"/comms/email/scheduling"},{"title":"Reminders (Return to Inbox)","icon":"bell","href":"/comms/email/reminders"},{"title":"Threads","sidebarTitle":"Reading \u0026 replying","icon":"messages","href":"/comms/email/threads"},{"title":"Blocked Senders","icon":"ban","href":"/comms/email/blocked-senders"},{"title":"How threading works","icon":"circle-nodes","href":"/comms/email/threading"},{"title":"Troubleshooting","icon":"wrench","href":"/comms/email/troubleshooting"}]},{"group":"SMS","pages":[{"title":"SMS","sidebarTitle":"Overview","icon":"message","href":"/comms/sms/overview"},{"title":"Sending SMS","icon":"paper-plane","href":"/comms/sms/sending"},{"title":"Receiving SMS","icon":"inbox","href":"/comms/sms/receiving"},{"title":"Phone and Texting Registration","sidebarTitle":"Registration","icon":"shield-check","href":"/comms/sms/a2p-registration"},{"title":"Troubleshooting","icon":"wrench","href":"/comms/sms/troubleshooting"}]},{"group":"Voice \u0026 Calls","pages":[{"title":"Voice \u0026 Calls","sidebarTitle":"Overview","icon":"phone","mode":"wide","href":"/comms/voice/overview"},{"title":"Dialer","icon":"phone-arrow-up-right","href":"/comms/voice/dialer"},{"title":"Recording","icon":"microphone","href":"/comms/voice/recording"},{"title":"Voicemail","icon":"voicemail","href":"/comms/voice/voicemail"},{"title":"Caller verification","icon":"shield-check","href":"/comms/voice/verification"},{"title":"Caller ID","icon":"id-card","href":"/comms/voice/caller-id"},{"title":"Phone \u0026 SMS Numbers","icon":"phone-volume","href":"/comms/voice/numbers"},{"title":"Sending Pools","icon":"layer-group","href":"/comms/voice/pools"},{"title":"Troubleshooting","icon":"wrench","href":"/comms/voice/troubleshooting"}]},{"group":"Chat / Widget","pages":[{"title":"Chat \u0026 Widget","sidebarTitle":"Overview","icon":"comment","href":"/comms/chat/overview"},{"title":"Install the widget","icon":"code","href":"/comms/chat/widget-install"},{"title":"AI Agent","icon":"sparkles","href":"/comms/chat/ai-agent"},{"title":"Insights","icon":"chart-simple","href":"/comms/chat/insights"},{"title":"Suggested Questions and Page Prompts","icon":"message-lines","href":"/comms/chat/page-prompts"},{"title":"Office Hours and Email Follow-Up","icon":"clock","href":"/comms/chat/office-hours"},{"title":"Buttons After an Answer","icon":"circle-check","href":"/comms/chat/answer-buttons"},{"title":"On Phones and From the Keyboard","icon":"mobile","href":"/comms/chat/phones-and-keyboards"},{"title":"Help in the Widget","icon":"book-open","href":"/comms/chat/help"},{"title":"Files and Emoji","icon":"paperclip","href":"/comms/chat/files"},{"title":"Chat Routing","icon":"route","href":"/comms/chat/routing"},{"title":"Visitors","icon":"users-viewfinder","href":"/comms/chat/visitors"},{"title":"Known Customers","icon":"user-check","href":"/comms/chat/known-customers"}]},{"group":"Conversations \u0026 Threading","pages":[{"title":"Conversations \u0026 Threading","sidebarTitle":"Overview","icon":"messages","href":"/comms/conversations/overview"},{"title":"Stages \u0026 Rules","icon":"diagram-project","href":"/comms/conversations/stages"}]},{"group":"Inbox","pages":[{"title":"Inbox","sidebarTitle":"Overview","icon":"inbox","href":"/comms/inbox/overview"},{"title":"Inbox Views","icon":"filter","href":"/comms/inbox/views"},{"title":"Routing Rules","icon":"route","href":"/comms/inbox/routing"}]},{"group":"Templates \u0026 Snippets","pages":[{"title":"Report templates","sidebarTitle":"Report templates","icon":"file-lines","href":"/comms/templates/overview"},{"title":"Snippets","icon":"note-sticky","href":"/comms/templates/snippets"}]},{"group":"Deliverability","pages":[{"title":"Deliverability","sidebarTitle":"Overview","description":"SPF, DKIM, DMARC, sender reputation, and how to manage sending domains in Custral.","icon":"shield-check","href":"/comms/deliverability/overview"},{"title":"Suppressions","sidebarTitle":"Overview","icon":"ban","href":"/comms/suppressions/overview"},{"title":"Troubleshooting","description":"Fixes for email that lands in spam, bounces, or gets throttled: the inbox-placement side of deliverability.","icon":"wrench","href":"/comms/deliverability/troubleshooting"}]},{"group":"Calendar","pages":[{"title":"Calendar","icon":"calendar-days","href":"/comms/calendar/overview"},{"title":"Recurring events","icon":"repeat","href":"/comms/calendar/recurring-events"},{"title":"Responding to invites","icon":"calendar-check","href":"/comms/calendar/responding-to-invites"},{"title":"Stella in Meetings","icon":"robot","href":"/comms/calendar/meeting-assistant"}]},{"group":"Scheduling \u0026 Forms","pages":[{"title":"Scheduling","icon":"calendar-check","href":"/comms/scheduling/overview"},{"title":"Forms","icon":"rectangle-list","href":"/comms/forms/overview"}]},{"group":"Playbooks","pages":[{"title":"Playbooks","icon":"book-open","href":"/comms/playbooks/overview"},{"title":"Playbook groups \u0026 assignments","icon":"layer-group","href":"/comms/playbooks/groups"},{"title":"Playbook analytics","icon":"chart-line","href":"/comms/playbooks/analytics"}]},{"group":"Coaching","pages":[{"title":"Coaching Scorecards","icon":"clipboard-check","href":"/comms/coaching/scorecards"},{"title":"Coaching Goals","icon":"bullseye","href":"/comms/coaching/goals"},{"title":"Coaching Trends","icon":"chart-line","href":"/comms/coaching/trends"},{"title":"Call Library","icon":"bookmark","href":"/comms/coaching/library"},{"title":"Call moments","icon":"wave-pulse","href":"/comms/coaching/moments"},{"title":"Live coach","icon":"headset","href":"/comms/coaching/live-coach"}]}]},{"tab":"Data Structures","pages":[{"title":"Data Structures","href":"/data/overview"}]},{"tab":"Surfaces","pages":[{"title":"Surfaces","href":"/surfaces/overview"}]},{"tab":"Blocks","pages":[{"title":"Blocks","href":"/blocks/overview"}]},{"tab":"Team","pages":[{"title":"Team","href":"/team/overview"}]},{"tab":"Automations","pages":[{"title":"Automations","href":"/automation/overview"}]},{"tab":"Business Intelligence","pages":[{"title":"Business Intelligence","href":"/bi/overview"}]},{"tab":"Revenue","pages":[{"title":"Revenue","href":"/revenue/overview"}]}]},{"product":"Developer References","icon":"square-terminal","pages":[{"title":"Developer References","href":"/dev/overview"}]},{"product":"Product Updates","icon":"crystal-ball","pages":[{"title":"Product Updates","href":"/product/overview"}]},{"product":"Integrations","icon":"flask-gear","pages":[{"title":"Integrations","href":"/integrations/overview"}]}]},"basePath":"","title":"Suppressions - Custral Docs","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["10e4515597"],"chunks":["BannerMarkdown-CXEEkV6J.js","dist-lvhuD9Du.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-D1Z-ELXV.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js"]}