Messaging
SendGrid
A SendGrid integration stores outbound email credentials for Mobius so loops can send plain, HTML, reply, and templated email.
Use SendGrid when the run owns the outbound email step. Use Gmail when mail should be sent from a connected Gmail mailbox.
Capability map
| Capability | Value |
|---|---|
| Provider ID | sendgrid |
| Auth kind | api_key |
| Connect flow | Direct integration row |
| Actions | Yes |
| Events | No |
| Webhook delivery | No |
| Event samples | No |
| Live status | No |
Connect SendGrid
| Surface | Support |
|---|---|
| App | Use the integration form when SendGrid appears in Govern > Integrations. |
| CLI | The mobius CLI does not connect SendGrid integrations yet. Use the app or API. |
| API | Create an integration row with provider: "sendgrid", credential api_key, and config from. |
The from address is non-secret config. The API key is stored as secret
credentials and is never returned by read endpoints.
{
"name": "default",
"provider": "sendgrid",
"credentials": {
"api_key": "$SENDGRID_API_KEY"
},
"config": {
"from": "briefs@acme.example"
}
}Actions
email.reply
email.send
email.send_templateThe action prefix is email. for compatibility, while the provider ID is
sendgrid. Use email.send_template when subject or body should be rendered
from run data.
Events
SendGrid does not register source events. Start the run from another trigger, then call email actions.
Next
- Keep secrets out of specs with integrations.
- Call email from action steps.
- Review action safety in actions.