Skip to content

Latest commit

 

History

History
33 lines (20 loc) · 1.53 KB

emails.md

File metadata and controls

33 lines (20 loc) · 1.53 KB
Raw

Emails

We use SendGrid to send and receive emails.

Emails are sent using the Django email API via SendGrid's SMTP servers.

Emails are received via SendGrid's inbound parse webhook, where they send us a POST request to an endpoint of ours (/email/receive/) whenever we get an email.

We also receive delivery status notifications to a events webhook where they POST updates to /email/events/.

Each environment (dev/test/prod) has its own email subdomain.

Development setup

The events webhook needs to be configured manually and is difficult to test because we only get one webhook (which we use for production).

To listen for inbound emails in your development environment run ngrok. This will print the public endpoint, e.g. "https://90c8-194-193-130-131.ngrok.io".

# Start ngrok (https://ngrok.com/) and take note of the address
ngrok http 8000

Then, in a separate terminal session, update dev Sendgrid settings via API

inv ngrok https://90c8-194-193-130-131.ngrok.io

Then wait a minute or so for these settings to propagate. You can see these settings in the SendGrid web UI here.

Dev emails can be sent to the subdomain em9463.dev-mail.anikalegal.com. Check the case email tab in the Clerk web UI to get a test email.