Appearance
SendGrail
SendGrail
SendGrail's own delivery service, available through the SendGrail Provider add-on.
Requires the SendGrail Provider add-on
This provider is not part of the SendGrail plugin itself. Install the SendGrail Provider add-on alongside it, then SendGrail appears at the top of the connection picker. With the add-on inactive the provider is simply absent — nothing else changes.
Step-by-step
Install the add-on
Upload the SendGrail Provider plugin to /wp-content/plugins/ and activate it. It needs the SendGrail plugin active first; if SendGrail is missing or too old the add-on stays inert and shows a notice instead of half-working.
Verify your sending domain
In your SendGrail dashboard, add your domain and publish the DKIM and SPF records it gives you at your DNS provider. SendGrail only delivers from a verified domain.
Create an API key
In the dashboard go to API Keys and create one with sending access. It starts with sg_ and is shown once — copy it then.
Add the connection
SendGrail → Connections → Add Connection → pick SendGrail.
Fill in:
- Connection Name: SendGrail
- From Email: an address on your verified domain
- From Name: display name
- API Key: the
sg_...key from step 3
Click Save.
Test
SendGrail → Test Email → pick the connection → send.
Keeping the key out of the database
Set the key store to wp-config.php constants on the connection form and define it instead:
php
define('SENDGRAIL_PROVIDER_API_KEY', 'sg_your_key_here');The connection then reads the constant at send time and stores nothing.
Troubleshooting
- SendGrail is missing from the provider list — the add-on is inactive, or the SendGrail plugin predates provider add-on support. Check Plugins for a notice from SendGrail Provider.
- Domain not verified — finish DNS verification in the dashboard; propagation can take up to an hour.
- Existing connections stopped sending after deactivating the add-on — expected. The connections are kept, but with no handler registered those emails fall back to WordPress's own mailer. Reactivate the add-on to resume.
What's next
- Email Routing — route specific emails through SendGrail.
- Failure Alerts — get pinged on rejections.
- Registering a Custom Provider — how the add-on plugs in.