---
title: "SendGrid"
description: "Control SendGrid API key retrieval for AI agents"
url: "https://gazebohq.com/services/sendgrid"
---

The SendGrid preset stores an API key for approved agent retrieval. Use SendGrid's key permissions to distinguish mail sending from account administration or reporting. Gazebo returns the configured key to the runtime; it does not send messages, inspect recipients or proxy SendGrid API calls.

## Keep email credentials separate by purpose

An email credential can create real external effects, including messages sent to customers. Configure restricted API-key permissions in SendGrid and avoid sharing a broad account key with every automation. Gazebo records credential access and can stop later retrieval, but it cannot limit message recipients, undo a send or invalidate a key already returned. Sender verification, content review, suppression handling and downstream delivery records remain outside the retrieval boundary.

## How it works

1. Create a SendGrid API key with the minimum permissions needed, such as mail sending rather than full account access.
2. Choose SendGrid in Gazebo and store the key in the api_key field. Use separate service entries where environments require separate credentials.
3. Grant retrieval to the intended agent. Its runtime retrieves the key and calls SendGrid directly with the provider's required authentication.
4. Review Gazebo access records alongside SendGrid delivery and account records. Revoke the provider key if a delivered copy should no longer work.

## Use cases

**Transactional email automation:** Give a notification runtime a dedicated key with the necessary SendGrid mail permissions. Recipient rules and message approval belong in your application or provider configuration, not Gazebo's retrieval grant.

**Separate reporting credentials:** Where SendGrid permissions support the required reporting endpoints, use a separate restricted key for analytics rather than sharing the sending key. Revoke either credential independently at the provider when required.
