kurrier
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

  1. Sign in to the SendGrid dashboard.
  2. Open Settings → API Keys.
  3. Select Create API Key.
  4. Give it a recognizable name such as Kurrier.
  5. 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.
  6. 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

  1. Open Settings → Providers in Kurrier.
  2. Select Add Provider → SendGrid.
  3. Paste the API key.
  4. Save the provider.
  5. 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

  1. Open Identities → Add Domain in Kurrier.
  2. Select the SendGrid provider.
  3. Add the DNS records shown by Kurrier and SendGrid at your DNS host.
  4. Wait for DNS propagation and verify the domain.
  5. Create the email identities you want to use.

SendGrid may also require sender identity verification before it accepts mail from an address.

Troubleshooting

ProblemWhat to check
Connection verification failsConfirm that the key is active and has the permissions requested by Kurrier.
401 or authentication errorRe-copy the key or create a replacement; verify that no spaces were added.
403 or sender rejectionConfirm that the sender or domain is verified in SendGrid.
429 or rate-limit errorReview the account's sending limits and retry later.
Message appears sent but is not deliveredCheck 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.

On this page