# Email deliverability

A step of the [Cloud application](https://gradus.kazet.blog/tree/cloud-application) tree on Gradus, in the Serving & compute area: HTTP, workers, scaling.

Page: https://gradus.kazet.blog/tree/cloud-application/step/email-deliverability

Hear about mail that fails: record bounces and complaints, stop sending to those addresses and retry only what can recover.

Usually comes after: [Transactional email](https://gradus.kazet.blog/tree/cloud-application/step/transactional-email).

## Prompt for your AI assistant

```
Read the email decision record in docs/decisions. Add the provider's webhook for bounces and complaints and verify its signature. Record them in a suppression list that the email module checks before every send, so nothing goes to those addresses again. Send through the background worker if this service has one, retrying temporary failures only. Write in docs/ how to see what failed and how to release an address from the list.
```

Every step of the tree: https://gradus.kazet.blog/tree/cloud-application/llms.txt