Configuring Providers
SendGrid
Connect SendGrid to Kurrier for API-based email delivery.
SendGrid
Kurrier can send mail through Twilio SendGrid's API. You retain control of the SendGrid account, verified senders, sending limits, and billing.
Before you begin
You need:
- A SendGrid account
- A verified sender or authenticated domain
- Permission to create an API key
- Workspace owner or administrator access in Kurrier
Create a restricted API key
- Sign in to the SendGrid dashboard.
- Open Settings → API Keys.
- Select Create API Key.
- Give it a recognizable name such as
Kurrier. - Prefer Restricted Access and grant the permissions requested by Kurrier. At minimum, sending requires Mail Send access; connection verification may also require read access to basic account information.
- Create the key and copy it immediately.
SendGrid shows the complete key only once. If it is lost, create a replacement rather than trying to recover it.
Add SendGrid to Kurrier
- Open Settings → Providers in Kurrier.
- Select Add Provider → SendGrid.
- Paste the API key.
- Save the provider.
- Select Verify Connection.
Kurrier displays a verified status after the key is accepted.
Treat the SendGrid API key as a password. Do not place it in browser code, commit it to a repository, or include it in a support request.
Add and authenticate a domain
- Open Identities → Add Domain in Kurrier.
- Select the SendGrid provider.
- Add the DNS records shown by Kurrier and SendGrid at your DNS host.
- Wait for DNS propagation and verify the domain.
- Create the email identities you want to use.
SendGrid may also require sender identity verification before it accepts mail from an address.
Troubleshooting
| Problem | What to check |
|---|---|
| Connection verification fails | Confirm that the key is active and has the permissions requested by Kurrier. |
401 or authentication error | Re-copy the key or create a replacement; verify that no spaces were added. |
403 or sender rejection | Confirm that the sender or domain is verified in SendGrid. |
429 or rate-limit error | Review the account's sending limits and retry later. |
| Message appears sent but is not delivered | Check SendGrid Email Activity, bounces, blocks, and suppression lists. |
If you rotate the API key in SendGrid, update the provider credentials in Kurrier before revoking the old key.