Integrations
SendGrid
A SendGrid integration stores outbound email credentials for Mobius so agents can send plain, HTML, reply, and templated email.
Use SendGrid when the agent sends the mail itself. 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 Library > 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 data the agent already has.
Events
SendGrid does not register source events. Start the work another way, such as a message to the agent or a routine, then call email actions from that turn.
Next
- Keep credentials in integrations.
- Grant email actions to an agent from actions.
- Review action safety in actions.