--- title: Suppressions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Email Sending](https://developers.cloudflare.com/api/python/resources/email_sending) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Suppressions ##### [List account Email Sending suppressions](https://developers.cloudflare.com/api/python/resources/email_sending/subresources/suppressions/methods/list) email\_sending.suppressions.list(SuppressionListParams\*\*kwargs) -> SyncCursorPagination\[[SuppressionListResponse]()] GET/accounts/{account\_id}/email/sending/suppressions ##### [Get account Email Sending suppression](https://developers.cloudflare.com/api/python/resources/email_sending/subresources/suppressions/methods/get) email\_sending.suppressions.get(strsuppression\_id, SuppressionGetParams\*\*kwargs) -> [SuppressionGetResponse]() GET/accounts/{account\_id}/email/sending/suppressions/{suppression\_id} ##### [Create account Email Sending suppression](https://developers.cloudflare.com/api/python/resources/email_sending/subresources/suppressions/methods/create) email\_sending.suppressions.create(SuppressionCreateParams\*\*kwargs) -> [SuppressionCreateResponse]() POST/accounts/{account\_id}/email/sending/suppressions ##### [Update account Email Sending suppression](https://developers.cloudflare.com/api/python/resources/email_sending/subresources/suppressions/methods/edit) email\_sending.suppressions.edit(strsuppression\_id, SuppressionEditParams\*\*kwargs) -> [SuppressionEditResponse]() PATCH/accounts/{account\_id}/email/sending/suppressions/{suppression\_id} ##### [Delete account Email Sending suppression](https://developers.cloudflare.com/api/python/resources/email_sending/subresources/suppressions/methods/delete) email\_sending.suppressions.delete(strsuppression\_id, SuppressionDeleteParams\*\*kwargs) -> [SuppressionDeleteResponse]() DELETE/accounts/{account\_id}/email/sending/suppressions/{suppression\_id} ##### [Bulk import account Email Sending suppressions](https://developers.cloudflare.com/api/python/resources/email_sending/subresources/suppressions/methods/import) email\_sending.suppressions.import\_(SuppressionImportParams\*\*kwargs) -> [SuppressionImportResponse]() POST/accounts/{account\_id}/email/sending/suppressions/bulk ##### ModelsExpand Collapse
class SuppressionListResponse: … id: str Unique identifier for this suppression. formatuuid Link to this property created\_at: datetime When the suppression was created. formatdate-time Link to this property email: str The suppressed email address. formatemail Link to this property expires\_at: Optional\[datetime] When the suppression expires. Null for a permanent suppression. formatdate-time Link to this property read\_only: bool Whether clients may mutate this suppression. This is determined by the server and must not be inferred from reason. Link to this property reason: str Why the address is suppressed: manual, complaint, hard_bounce, soft_bounce, or policy. Link to this property note: Optional\[str] Advisory note for this suppression, if any. Link to this property
scope: Optional\[Scope] Where the suppression applies: account for every sending domain of the account, or sending_domain for one envelope MAIL FROM domain. One of the following:
class ScopeType: … type: Literal\["account"] Blocks the recipient for every sending domain of the account. Link to this property
Link to this property
class ScopeUnionMember1: … type: Literal\["sending\_domain"] Blocks the recipient only for mail whose envelope MAIL FROM uses value. Link to this property value: str The sending domain: the domain part of the envelope MAIL FROM, lowercase, without a trailing dot. maxLength1024 Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_list_response%20%3E%20(schema)>)
class SuppressionGetResponse: … id: str Unique identifier for this suppression. formatuuid Link to this property created\_at: datetime When the suppression was created. formatdate-time Link to this property email: str The suppressed email address. formatemail Link to this property expires\_at: Optional\[datetime] When the suppression expires. Null for a permanent suppression. formatdate-time Link to this property read\_only: bool Whether clients may mutate this suppression. This is determined by the server and must not be inferred from reason. Link to this property reason: str Why the address is suppressed: manual, complaint, hard_bounce, soft_bounce, or policy. Link to this property note: Optional\[str] Advisory note for this suppression, if any. Link to this property
scope: Optional\[Scope] Where the suppression applies: account for every sending domain of the account, or sending_domain for one envelope MAIL FROM domain. One of the following:
class ScopeType: … type: Literal\["account"] Blocks the recipient for every sending domain of the account. Link to this property
Link to this property
class ScopeUnionMember1: … type: Literal\["sending\_domain"] Blocks the recipient only for mail whose envelope MAIL FROM uses value. Link to this property value: str The sending domain: the domain part of the envelope MAIL FROM, lowercase, without a trailing dot. maxLength1024 Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_get_response%20%3E%20(schema)>)
class SuppressionCreateResponse: … id: str The suppression’s identifier. formatuuid Link to this property
scope: Optional\[Scope] Where the suppression applies: account for every sending domain of the account, or sending_domain for one envelope MAIL FROM domain. One of the following:
class ScopeType: … type: Literal\["account"] Blocks the recipient for every sending domain of the account. Link to this property
Link to this property
class ScopeUnionMember1: … type: Literal\["sending\_domain"] Blocks the recipient only for mail whose envelope MAIL FROM uses value. Link to this property value: str The sending domain: the domain part of the envelope MAIL FROM, lowercase, without a trailing dot. maxLength1024 Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_create_response%20%3E%20(schema)>)
class SuppressionEditResponse: … id: str Unique identifier for this suppression. formatuuid Link to this property created\_at: datetime When the suppression was created. formatdate-time Link to this property email: str The suppressed email address. formatemail Link to this property expires\_at: Optional\[datetime] When the suppression expires. Null for a permanent suppression. formatdate-time Link to this property read\_only: bool Whether clients may mutate this suppression. This is determined by the server and must not be inferred from reason. Link to this property reason: str Why the address is suppressed: manual, complaint, hard_bounce, soft_bounce, or policy. Link to this property note: Optional\[str] Advisory note for this suppression, if any. Link to this property
scope: Optional\[Scope] Where the suppression applies: account for every sending domain of the account, or sending_domain for one envelope MAIL FROM domain. One of the following:
class ScopeType: … type: Literal\["account"] Blocks the recipient for every sending domain of the account. Link to this property
Link to this property
class ScopeUnionMember1: … type: Literal\["sending\_domain"] Blocks the recipient only for mail whose envelope MAIL FROM uses value. Link to this property value: str The sending domain: the domain part of the envelope MAIL FROM, lowercase, without a trailing dot. maxLength1024 Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_edit_response%20%3E%20(schema)>)
class SuppressionDeleteResponse: … id: str The suppression’s identifier. formatuuid Link to this property
scope: Optional\[Scope] Where the suppression applies: account for every sending domain of the account, or sending_domain for one envelope MAIL FROM domain. One of the following:
class ScopeType: … type: Literal\["account"] Blocks the recipient for every sending domain of the account. Link to this property
Link to this property
class ScopeUnionMember1: … type: Literal\["sending\_domain"] Blocks the recipient only for mail whose envelope MAIL FROM uses value. Link to this property value: str The sending domain: the domain part of the envelope MAIL FROM, lowercase, without a trailing dot. maxLength1024 Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_delete_response%20%3E%20(schema)>)
class SuppressionImportResponse: … deduplicated: int Number of items dropped because their email address and scope repeated an earlier item in this request. Counted once and excluded from items. Link to this property errors: int Number of items that failed to import due to an unexpected error. Link to this property invalid: int Number of items with an invalid email address or sending domain. Link to this property
items: List\[Item] Per-item results, in the same order as the request body. index: int Zero-based index of this item in the request body. Link to this property
status: Literal\["processed", "invalid", "error", "skipped"] Outcome for this item. One of the following: "processed" Link to this property "invalid" Link to this property "error" Link to this property "skipped" Link to this property
Link to this property id: Optional\[str] The created or promoted suppression’s identifier. Present when status is processed. formatuuid Link to this property email: Optional\[str] The submitted email address for this item. formatemail Link to this property error: Optional\[str] Human-readable error message. Present when status is invalid, error, or skipped. Link to this property
scope: Optional\[ItemScope] Where the suppression applies: account for every sending domain of the account, or sending_domain for one envelope MAIL FROM domain. One of the following:
class ItemScopeType: … type: Literal\["account"] Blocks the recipient for every sending domain of the account. Link to this property
Link to this property
class ItemScopeUnionMember1: … type: Literal\["sending\_domain"] Blocks the recipient only for mail whose envelope MAIL FROM uses value. Link to this property value: str The sending domain: the domain part of the envelope MAIL FROM, lowercase, without a trailing dot. maxLength1024 Link to this property
Link to this property
Link to this property
Link to this property processed: int Number of items successfully created or promoted. Link to this property skipped: int Number of items skipped because the existing suppression is not customer-managed (for example, a read-only policy suppression). Link to this property total: int Total number of items in the request body, including duplicates. Link to this property
[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_import_response%20%3E%20(schema)>)