SendGrid

Let your agents send transactional emails, manage marketing contacts and lists, retrieve dynamic templates, and monitor email statistics via the SendGrid API.

Connection

Authentication: API key.
Required settings:
- Region — Use “api” (default) for global accounts, or “api.eu” for EU-resident accounts.

Sign in at app.sendgrid.com → Settings → API Keys → Create API Key. Name it, choose “Restricted Access”, and grant at minimum: Mail Send (full access), Marketing Contacts (read/write), SSO (read only), Statistics (read only). Copy the key (starts with SG.). If your account is EU-resident, select “eu” in the Region field.See SendGrid’s documentation.

Read actions (10)

Action	Description
`count_contacts`	Retrieve the total number of marketing contacts in the account.
`get_global_stats`	Retrieve global email statistics (requests, delivered, opens, clicks, bounces, etc.) for a date range. start_date is required (YYYY-MM-DD format). end_date defaults to today.
`get_list`	Retrieve a single marketing list by ID, including its contact count.
`get_scopes`	Retrieve the list of scopes (permissions) granted to the API key. Use as a connectivity probe.
`get_template`	Retrieve a single transactional template by ID, including its versions.
`list_bounces`	List all bounced email addresses. Supports start_time and end_time (unix timestamps) for filtering, plus limit (page size) and offset pagination.
`list_global_suppressions`	List all globally suppressed email addresses (addresses unsubscribed from all emails).
`list_lists`	List all marketing contact lists. Supports page_size (1-1000, default 100) and page_token pagination.
`list_templates`	List all transactional templates. Pass generations=dynamic to retrieve only dynamic templates. Supports page_size and page_token pagination.
`search_contacts_by_emails`	Retrieve up to 100 contacts matching the given email addresses (case-insensitive). emails: array of up to 100 strings.

Write actions (4)

Action	Description
`create_list`	Create a new marketing contact list. name: string (1-100 characters).
`remove_contacts_from_list`	Remove contacts from a list (async, returns a job_id). Contacts are not deleted, only removed from the list. contact_ids: comma-separated string of contact IDs.
`send_email`	Send a transactional email. Returns HTTP 202 with no body on success. Attachments are not supported (binary content excluded). personalizations: array of objects (each with to [array of {email, name?}], cc? [array], bcc? [array], subject?, dynamic_template_data?, custom_args?, headers?, substitutions?). from: object {email, name?}. subject: string (message-level, overridden by personalizations). content: array of objects [{type: string, value: string}]. reply_to?: object {email, name?}. template_id?: string (starts with d- for dynamic templates). categories?: array of strings. send_at?: unix timestamp (max 72 h).
`upsert_contacts`	Add or update up to 30,000 marketing contacts (async, returns a job_id for status checks via GET /v3/marketing/contacts/imports/{job_id}). contacts: array of objects, each with at least one identifier (email, phone_number_id, external_id, or anonymous_id). list_ids?: array of list ID strings to add contacts to.

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

Connection

Read actions (10)

Write actions (4)

Permissions

​Connection

​Read actions (10)

​Write actions (4)

​Permissions

Connection

Read actions (10)

Write actions (4)

Permissions