--- title: Suppressions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Email Sending](https://developers.cloudflare.com/api/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/resources/email_sending/subresources/suppressions/methods/list) GET/accounts/{account\_id}/email/sending/suppressions ##### [Get account Email Sending suppression](https://developers.cloudflare.com/api/resources/email_sending/subresources/suppressions/methods/get) GET/accounts/{account\_id}/email/sending/suppressions/{suppression\_id} ##### [Create account Email Sending suppression](https://developers.cloudflare.com/api/resources/email_sending/subresources/suppressions/methods/create) POST/accounts/{account\_id}/email/sending/suppressions ##### [Update account Email Sending suppression](https://developers.cloudflare.com/api/resources/email_sending/subresources/suppressions/methods/edit) PATCH/accounts/{account\_id}/email/sending/suppressions/{suppression\_id} ##### [Delete account Email Sending suppression](https://developers.cloudflare.com/api/resources/email_sending/subresources/suppressions/methods/delete) DELETE/accounts/{account\_id}/email/sending/suppressions/{suppression\_id} ##### [Bulk import account Email Sending suppressions](https://developers.cloudflare.com/api/resources/email_sending/subresources/suppressions/methods/import) POST/accounts/{account\_id}/email/sending/suppressions/bulk ##### ModelsExpand Collapse

SuppressionListResponse object {id, created\_at, email, 5 more }

id: string Unique identifier for this suppression. formatuuid Link to this property created\_at: string When the suppression was created. formatdate-time Link to this property email: string The suppressed email address. formatemail Link to this property expires\_at: string When the suppression expires. Null for a permanent suppression. formatdate-time Link to this property read\_only: boolean Whether clients may mutate this suppression. This is determined by the server and must not be inferred from reason. Link to this property reason: string Why the address is suppressed: manual, complaint, hard_bounce, soft_bounce, or policy. Link to this property note: optional string Advisory note for this suppression, if any. Link to this property

scope: optional object {type } or object {type, value } 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:

Type object {type }

type: "account" Blocks the recipient for every sending domain of the account. Link to this property

Link to this property

object {type, value }

type: "sending\_domain" Blocks the recipient only for mail whose envelope MAIL FROM uses value. Link to this property value: string 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](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_list_response%20%3E%20(schema)>)

SuppressionGetResponse object {id, created\_at, email, 5 more }

scope: optional object {type } or object {type, value } 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:

Type object {type }

type: "account" Blocks the recipient for every sending domain of the account. Link to this property

Link to this property

object {type, value }

Link to this property

[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_get_response%20%3E%20(schema)>)

SuppressionCreateResponse object {id, scope }

id: string The suppression’s identifier. formatuuid Link to this property

scope: optional object {type } or object {type, value } 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:

Type object {type }

type: "account" Blocks the recipient for every sending domain of the account. Link to this property

Link to this property

object {type, value }

Link to this property

[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_create_response%20%3E%20(schema)>)

SuppressionEditResponse object {id, created\_at, email, 5 more }

scope: optional object {type } or object {type, value } 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:

Type object {type }

type: "account" Blocks the recipient for every sending domain of the account. Link to this property

Link to this property

object {type, value }

Link to this property

[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_edit_response%20%3E%20(schema)>)

SuppressionDeleteResponse object {id, scope }

id: string The suppression’s identifier. formatuuid Link to this property

scope: optional object {type } or object {type, value } 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:

Type object {type }

type: "account" Blocks the recipient for every sending domain of the account. Link to this property

Link to this property

object {type, value }

Link to this property

[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_delete_response%20%3E%20(schema)>)

SuppressionImportResponse object {deduplicated, errors, invalid, 4 more }

deduplicated: number 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: number Number of items that failed to import due to an unexpected error. Link to this property invalid: number Number of items with an invalid email address or sending domain. Link to this property

items: array of object {index, status, id, 3 more } Per-item results, in the same order as the request body.

index: number Zero-based index of this item in the request body. Link to this property

status: "processed"or "invalid"or "error"or "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 string The created or promoted suppression’s identifier. Present when status is processed. formatuuid Link to this property email: optional string The submitted email address for this item. formatemail Link to this property error: optional string Human-readable error message. Present when status is invalid, error, or skipped. Link to this property

scope: optional object {type } or object {type, value } 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:

Type object {type }

type: "account" Blocks the recipient for every sending domain of the account. Link to this property

Link to this property

object {type, value }

Link to this property

Link to this property processed: number Number of items successfully created or promoted. Link to this property skipped: number Number of items skipped because the existing suppression is not customer-managed (for example, a read-only policy suppression). Link to this property total: number 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)>)