kurrier
Configuring Providers

SendGrid

Setting up SendGrid

SendGrid

SendGrid is a popular transactional and marketing email platform by Twilio. Kurrier integrates directly with SendGrid’s REST API to handle sending and tracking emails using a single API key.


1. Overview

Connecting SendGrid to Kurrier allows you to send emails through your SendGrid account without configuring SMTP. You only need your SendGrid API Key — Kurrier will handle everything else via the SendGrid API.


2. Adding SendGrid in Kurrier

In Kurrier, go to:

Dashboard → Providers → Add Provider → SendGrid

You’ll see the following field:

FieldDescriptionExample
SENDGRID_API_KEYYour SendGrid API key (starts with SG.)SG.4aA4DyiCTValYwQQ.aC0RQSHrzdNeHFVMfIrgwn2RM3iVjkzIBNl

Click Submit to save. Kurrier will automatically validate the key and show ✅ Verified on success.


3. Where to Find Your API Key

  1. Log in to your SendGrid Dashboard.
  2. Go to Settings → API Keys.
  3. Click Create API Key.
  4. Name your key (e.g., Kurrier Integration).
  5. Under API Key Permissions, choose Full Access or Restricted Access (see below).
  6. Copy the generated key and paste it into Kurrier’s form.

⚠️ You won’t be able to view this key again after closing the dialog, so store it securely.


For Kurrier to send emails and verify the connection properly, your key must have at least the following permissions:

PermissionAccess LevelDescription
Mail SendFull AccessRequired for sending outbound emails
User AccountRead AccessUsed to validate the key and fetch account info
StatsRead AccessOptional, for analytics or usage data

You can choose Full Access if you’re unsure — it will work without issues, but restricted keys are safer for production.


5. Verify the Connection

After saving your key, click Verify Connection. Kurrier will attempt an authentication check with SendGrid’s API endpoint (https://api.sendgrid.com/v3/user/account).

✅ Success

You’ll see Verified next to your SendGrid provider.

⚠️ Failure

Check that:

  • The API key is active and copied correctly.
  • It has at least Mail Send permissions.
  • Outbound HTTPS connections to api.sendgrid.com are allowed from your server.

6. Troubleshooting

ErrorMeaningFix
401 UnauthorizedInvalid API key or missing permissionsRecheck your key or create a new one
403 ForbiddenDomain or sender not verifiedVerify your domain in SendGrid
429 Too Many RequestsRate limit exceededSlow down sending or request higher limits
500 Server ErrorTemporary SendGrid issueRetry after a few seconds

Tip: SendGrid keys always start with SG. — if yours doesn’t, double-check that you copied the correct key from the dashboard.