SDK Usage #
// Import typed helpers for full type safety
import { Hotglue } from "@hotglue/sdk";
import { toolName } from "@hotglue/sdk/sendgrid";
const client = new Hotglue({ apiKey: "hg_live_xxx" });
const result = await client.execute({
...toolName({ /* typed input */ }),
userId: "user_123",
});
// result is fully typed!
import { Hotglue } from "@hotglue/sdk";
const client = new Hotglue({ apiKey: "hg_live_xxx" });
const result = await client.execute({
integration: "sendgrid",
tool: "tool_name",
userId: "user_123",
input: { /* ... */ },
});
import { createHotglueTools } from "@hotglue/sdk";
import { Agent } from "@mastra/core/agent";
const hotglueTools = createHotglueTools({ apiKey: "hg_live_xxx" });
const agent = new Agent({
name: "SendGrid Agent",
model: "anthropic/claude-sonnet-4-0",
tools: () => hotglueTools({
integrations: ["sendgrid"],
userId: "user_123",
}),
});
Authentication Setup #
Create an API key in SendGrid with the appropriate permissions.
1. Access API Keys
- Log in to app.sendgrid.com
- Click Settings in the left sidebar
- Click API Keys
2. Create API Key
Click Create API Key and set:
Name
e.g., "Hotglue Integration"
Permissions
Restricted Access (recommended)
Mail Send
Full Access
Template Engine
Read Access
3. Copy API Key
Click Create & View and copy the key immediately.
SG.xxxxxxxxxxxxxxxxxxxxxxxx.xxxxx...
// Copy immediately — SendGrid only shows the key once.
Sender Verification
Before sending emails, verify your sender identity in Settings → Sender Authentication:
Domain Authentication
recommended for production
Single Sender
quick setup for testing