Control SendGrid API key retrieval for AI agents
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.
Common 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.
Connect SendGrid to Gazebo
Control agent credential retrieval for SendGrid. Record retrieval attempts and revoke future access.
Connect SendGrid