SendGrid
Send transactional and marketing emails via SendGrid.
Communicationapi_key_authproxywebhook_receive
Connect SendGrid
SendGrid uses API key authentication. Send your credentials directly via the connect endpoint:
POST /connect/v1/providers/sendgrid/connect
# Headers
Authorization: YOUR_JWT_TOKEN
Content-Type: application/json
# Body
{
"credentials": { "apiKey": "your-api-key" }
}
Subscribe to Webhooks
Set up a webhook subscription to receive real-time events from SendGrid:
POST /connect/v1/webhooks/sendgrid/subscribe
# Headers
Authorization: YOUR_JWT_TOKEN
Content-Type: application/json
# Body
{
"url": "https://your-app.com/webhook"
}
List your existing webhook subscriptions:
GET /connect/v1/webhooks/sendgrid/subscriptions
# Headers
Authorization: YOUR_JWT_TOKEN
Make API Calls via Proxy
Use the proxy endpoint to make authenticated API calls to SendGrid without managing tokens yourself. Calimatic Connect handles credential injection and token refresh automatically.
POST /connect/v1/proxy/sendgrid
# Headers
Authorization: YOUR_JWT_TOKEN
Content-Type: application/json
# Body
{
"method": "GET",
"path": "/me"
}
Check Status
Verify whether your SendGrid connection is active and credentials are valid:
GET /connect/v1/providers/sendgrid/status
# Headers
Authorization: YOUR_JWT_TOKEN
Disconnect
Remove the SendGrid connection and revoke stored credentials:
DELETE /connect/v1/providers/sendgrid/disconnect
# Headers
Authorization: YOUR_JWT_TOKEN