SendGrid
for LuumenAI
Read email activity and sender setup, then change SendGrid config with approval
Connect SendGrid and Luumen can answer questions about email delivery without you opening the dashboard. Pull the activity feed for a specific message, check which senders and domains are verified, list your dedicated IPs and their warm-up state. When something needs to change — adding an IP to a pool, updating a contact, activating a template version — Luumen shows the plan first and, by default, waits for your approval. Authentication is by API key.
The SendGrid toolbox
359 tools: 178 read, 181 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadCompleted stepsRetrieves the verification status of a SendGrid account, checking if Domain Authentication and Single Sender Verification have been completed.
- ReadDomain warn listRetrieves a list of domains known to implement DMARC (Domain-based Message Authentication, Reporting & Conformance) policies, categorized by failure type.
- ReadGet Email Activity CSV Download URLRetrieves a presigned S3 URL to download a CSV file of email activity data (up to 1M events, last 30 days).
- ReadExport contactsInitiates an asynchronous job to export Marketing Campaigns contacts to CSV or JSON.
- ReadExport contacts statusRetrieves the status of a contact export job and provides download URLs when ready.
- ReadExport single send statsExports Single Send campaign statistics in CSV format.
- ReadFilter all messagesFilter and retrieve email activity from the SendGrid Email Activity Feed API.
- ReadFilter messages by message idRetrieve detailed information about a specific email message by its unique message ID.
- ReadGet account offeringsRetrieves the offerings (email packages and add-ons) assigned to a specific customer account.
- ReadGet a contact by idRetrieves the full details of a single contact by their unique ID from SendGrid Marketing Campaigns.
- ReadGet a list of all ip addresses on your accountFetches your account's IP addresses with details such as pool association and warm-up status.
- ReadGet a list of all sendersRetrieves a list of all Sender identities associated with your SendGrid account.
- ReadGet a list of subusers assigned to an ipRetrieves a list of Subuser IDs assigned to a specific IP address in your SendGrid account.
- ReadGet all accountsRetrieves all accounts under the organization.
- ReadGet all automation statsRetrieve email statistics for SendGrid Marketing Automations (automated email workflows).
- ReadGet all available offeringsRetrieves all available SendGrid offerings for account provisioning.
- ReadGet All Single Sends CategoriesRetrieve all categories associated with your Marketing Campaigns Single Sends.
- ReadGet all existing exportsRetrieves all existing contact export jobs from SendGrid Marketing Campaigns.
- ReadGet all field definitionsRetrieve all field definitions including custom and reserved fields from Marketing Campaigns.
- ReadGet all ip pools that have associated ipsThe function lists your IP Pools and samples up to 10 IPs from each.
- ReadGet all sender identities**This endpoint allows you to retrieve a list of all sender identities that have been created for your account.**
- ReadGet all single sendsRetrieve a list of your Single Sends with brief details, including their IDs.
- ReadGet all single sends statsRetrieve email statistics for SendGrid Single Sends (one-time marketing email campaigns).
- ReadGet All SSO Certificates by IntegrationRetrieves all SSO (Single Sign-On) certificates associated with a specific IdP integration.
- ReadGet all sso integrations**This endpoint allows you to retrieve all SSO integrations tied to your Twilio SendGrid account.** The IDs returned by this endpoint can be used by the APIs additional endpoints to modify your SSO…
- ReadGet all verified sendersRetrieve all Sender Identities (verified/unverified) for an account via an endpoint.
- ReadGet Account StateRetrieve the current state of a customer account using the Account Provisioning API.
- ReadGet an SSO CertificateRetrieve an individual SSO certificate by its ID.
- ReadGet an sso integration**This endpoint allows you to retrieve an SSO integration by ID.** You can retrieve the IDs for your configurations from the response provided by the "Get All SSO Integrations" endpoint.
- ReadGet a specific senderRetrieves the details of a specific Marketing Sender by its unique ID.
- ReadGet a User's Account InformationRetrieves the authenticated user's SendGrid account details including account type (e.g., 'free', 'paid') and sender reputation score (0-100).
- ReadGet User ProfileRetrieve the authenticated user's profile details.
- ReadGet Automation Click Tracking StatsRetrieve click-tracking statistics for a specific SendGrid Marketing Automation.
- ReadGet automation stats by idRetrieve detailed stats for a specific Automation by ID, with optional date and aggregation filters, or use another endpoint to get stats for multiple Automations.
- ReadGet batched contacts by idsRetrieves multiple SendGrid Marketing Contacts by their IDs in a single batch request.
- ReadGet bounce statistics by classificationRetrieve daily bounce statistics filtered by a specific classification type.
- ReadGet Bulk Email Validation Job by IDRetrieves the details of a specific Bulk Email Address Validation Job by its ID.
- ReadGet Contacts by EmailsSearch for Marketing Campaigns contacts by their email addresses.
- ReadGet contacts by identifiersRetrieves up to 100 Marketing Campaigns contacts by searching for specific identifier values.
- ReadGet designRetrieves a specific design's details from your Design Library by its ID.
- ReadGet details for an ip addressRetrieves detailed information about a specific IP address on your SendGrid account.
- ReadGet details for an ip poolThis operation retrieves details of an IP Pool, such as name, ID, some sample IPs (up to 10), and the total IP count.
- ReadRetrieve all suppression groups for an email address**Retrieve all suppression groups for a specific email address.** This endpoint returns a list of all suppression groups in your SendGrid account, along with the suppression status of the specified…
- ReadGet engagement quality scoresRetrieve SendGrid Engagement Quality (SEQ) scores for a specified date range.
- ReadRetrieve email statistics by country and state provinceRetrieves email engagement statistics (opens, clicks) segmented by geographic location (country and state/province).
- ReadGet information on a single suppression groupRetrieves details for a single suppression group (also known as an unsubscribe group).
- ReadGet Marketing IntegrationRetrieve a specific Marketing Integration by its unique ID.
- ReadGet ips assigned to an ip poolRetrieves IP addresses assigned to a specific IP Pool.
- ReadRetrieve the warmup status for a specific ip addressRetrieve the warmup status for a specific dedicated IP address.
- ReadGet list contact countRetrieve the contact count and billable contact count for a specific marketing list.
- ReadGet list of segmentsRetrieves a filtered list of contact segments from SendGrid Marketing Campaigns V2.
- ReadGet Open Tracking SettingsRetrieves the current open tracking settings for your SendGrid account.
- ReadGet Recipient Upload Status (Legacy)Retrieves the upload status for recipients in the Legacy Marketing Campaigns contacts database (contactdb).
- ReadGet remaining ips count**This endpoint gets amount of IP Addresses that can still be created during a given period and the price of those IPs.**
- ReadGet sample contactsRetrieves a sample of up to 50 contacts from your Marketing Contacts database, sorted by email address.
- ReadGet SendGrid Pre-built DesignRetrieves details of a specific SendGrid pre-built design template by ID.
- ReadGet signed event webhook's public keyRetrieves the public key for a specific Event Webhook by ID.
- ReadGet single send by id**This endpoint allows you to retrieve details about one Single Send using a Single Send ID.** You can retrieve all of your Single Sends by making a GET request to the `/marketing/singlesends`…
- ReadGet single send click tracking stats by id**This endpoint lets you retrieve click-tracking stats for one Single Send**.
- ReadGet single sends searchSearch for Single Sends (marketing email campaigns) by name, status, and/or categories.
- ReadGet single send stats by idRetrieve individual Single Send stats using its ID.
- ReadGet subuser monthly statsRetrieves monthly email statistics for a specific subuser.
- ReadGet subusers engagement quality scoresRetrieve SendGrid Engagement Quality (SEQ) scores for all subusers on a specific date.
- ReadGet suppression groupsThis endpoint provides a list of user-created suppression groups and can return info for multiple groups when their IDs are added to the request with `?id=123456`.
- ReadGet teammate subuser accessRetrieve Subusers accessible to a specified Teammate, including their permission levels and scopes.
- ReadGet the credits for a subuserRetrieves credit information for a specific Subuser account, including the credit type (unlimited, recurring, or nonrecurring), reset frequency, remaining credits, total allowable credits, and used…
- ReadGet the default authenticationRetrieves the default domain authentication configuration for your SendGrid account.
- ReadGet the settings for a single event webhookRetrieves the configuration and settings for a single Event Webhook by its ID.
- ReadGet total contact countRetrieve the total number of contacts stored in your SendGrid Marketing Campaigns account.
- ReadRetrieve a list of scopes for which this user has accessRetrieve a list of scopes for which this user has access
- ReadImport contacts statusCheck the status of a contact import, update, or delete job in SendGrid Marketing Campaigns.
- ReadList all authenticated domainsRetrieve authenticated domain lists in pages using the `limit` parameter for page size and `offset` to start from specific list positions.
- ReadList all subusersRetrieve a paginated list of subusers with filtering options.
- ReadList api keysRetrieve user's API key names and IDs with this endpoint; keys themself cannot be retrieved for security.
- ReadList Bulk Email Validation JobsRetrieves a list of all Bulk Email Address Validation Jobs for the account.
- ReadList designsList designs from the Design Library.
- ReadListintegrationThis endpoint returns all the Integrations for the user making this call.
- ReadList sendgrid pre built designsThe `designs/pre-builts` endpoint fetches a list of Twilio SendGrid's ready-made designs, not user-specific ones, with 100 results per request by default, adjustable with `page_size`.
- ReadList the authenticated domain associated with the given userRetrieves all authenticated domains that have been assigned to a specific subuser.
- ReadRetrieve a bounceRetrieves details about a specific bounced email address from the SendGrid suppression list.
- ReadRetrieve a branded linkRetrieves a specific branded link by its ID.
- ReadRetrieve access requestsRetrieve a list of recent access requests using pagination with `limit` for page size and `offset` to control the start position for additional items.
- ReadRetrieve a count of recipientsRetrieve the total count of recipients in the Legacy Marketing Campaigns contact database.
- ReadRetrieve a custom fieldRetrieves a single custom field definition by its ID from SendGrid Marketing Campaigns.
- ReadRetrieve address whitelist mail settingsRetrieves your current address whitelist mail settings from SendGrid.
- ReadRetrieve a global suppressionChecks if an email address is in the global suppression list.
- ReadRetrieve a list of currently allowed ipsThis endpoint provides a list of authorized IP addresses for your account, each with creation, update dates, and a unique ID for potential removal.
- ReadRetrieve all alertsRetrieve all SendGrid alerts configured for your account.
- ReadRetrieve all assigned ipsRetrieves all IP addresses that are currently assigned to your account.
- ReadRetrieve all blocksRetrieves a paginated list of all blocked email addresses from your SendGrid account.
- ReadRetrieve all bouncesThis endpoint retrieves a paginated list of all your bounces, allowing customization of page size with `limit` and starting position with `offset` for multiple requests.
- ReadRetrieve all branded links**This endpoint allows you to retrieve all branded links**.
- ReadRetrieve all campaignsRetrieve a paginated list of campaigns in reverse creation order with the API endpoint.
- ReadRetrieve all categoriesRetrieve all email categories used for tracking and organizing email statistics.
- ReadRetrieve all custom fieldsRetrieve all custom field definitions for contacts.
- ReadRetrieve all global suppressionsRetrieves a paginated list of all email addresses that are globally suppressed from receiving any emails from your SendGrid account.
- ReadRetrieve all invalid emailsRetrieve paginated lists of invalid emails with 'limit' for page size and 'offset' to start from a specific position for lists exceeding the limit.
- ReadRetrieve all ip addressesRetrieve a paginated list of assigned/unassigned IPs with warmup status, pools, subusers, and DNS info.
- ReadRetrieve all ip pools**This endpoint allows you to get all of your IP pools.**
- ReadRetrieve all ip pools an ip address belongs toRetrieves details for a specific IP address including all IP pools it belongs to, subusers that can use it, warmup status, and reverse DNS record.
- ReadRetrieve All IPs Currently in WarmupRetrieve all IP addresses currently in the warmup process.
- ReadRetrieve all listsRetrieve all contact lists from your SendGrid account.
- ReadRetrieve all mail settingsRetrieve a paginated list of mail settings with their `enabled` status and descriptions.
- ReadRetrieve all of your event webhooksThe endpoint fetches all Event Webhooks as objects in an array, showing each webhook's configuration and ID, used to update, delete, or manage signature verification and OAuth settings.
- ReadRetrieve all parse settings**This endpoint allows you to retrieve all of your current inbound parse settings.**
- ReadRetrieve all pending teammates**This endpoint allows you to retrieve a list of all pending Teammate invitations.** Each teammate invitation is valid for 7 days.
- ReadRetrieve all recent access attemptsRetrieves a list of all IP addresses that have recently attempted to access your SendGrid account, either through the User Interface or the API.
- ReadRetrieve all recipients on a listRetrieves all recipients (contacts) belonging to a specific list in SendGrid's Legacy Marketing Campaigns.
- ReadRetrieve all reverse dns recordsThe endpoint provides a paginated list of Reverse DNS records, with optional IP prefix search and adjustable page size using 'limit' and 'offset' parameters.
- ReadRetrieve all scheduled sendsThe endpoint provides details of cancelled or paused scheduled sends but only if they have a `batch_id`.
- ReadRetrieve all spam reportsRetrieve spam reports in pages using `limit` for page size and `offset` to continue from a specific list position.
- ReadRetrieve all suppressionsRetrieve a list of all suppressions across all suppression groups.
- ReadRetrieve all suppressions for a suppression group**This endpoint allows you to retrieve all suppressed email addresses belonging to the given group.**
- ReadRetrieve all teammatesRetrieve a paginated list of Teammates with the `limit` parameter to set page size and `offset` to specify the starting point for additional items.
- ReadRetrieve all the ips in a specified poolRetrieves all IP addresses that are assigned to a specific IP pool.
- ReadRetrieve an authenticated domainRetrieves details of a specific authenticated domain by its unique ID.
- ReadRetrieve an existing api keyRetrieves the details of an existing SendGrid API key by its unique identifier.
- ReadRetrieve a reverse DNS recordRetrieves a specific reverse DNS (formerly IP Whitelabel) record by its ID.
- ReadRetrieve a single campaignRetrieves a specific campaign from SendGrid's Legacy Marketing Campaigns by its ID.
- ReadRetrieve a single listRetrieve detailed information about a specific marketing list by its unique ID.
- ReadRetrieve a single transactional templateRetrieves a single transactional template by its ID, including all associated template versions.
- ReadRetrieve a specific alertRetrieve details for a specific SendGrid alert by its ID.
- ReadRetrieve a specific allowed ipRetrieves details of a specific IP address from your SendGrid account's IP Access Management allow list using its unique rule ID.
- ReadRetrieve a specific blockRetrieves details for a specific email address from your SendGrid blocks list.
- ReadRetrieve a specific invalid emailRetrieves details about a specific email address from SendGrid's invalid email suppression list.
- ReadRetrieve a specific parse settingRetrieves a specific inbound parse webhook setting by hostname.
- ReadRetrieve a specific spam reportRetrieves a specific spam report by email address from SendGrid's suppression list.
- ReadRetrieve a specific transactional template versionRetrieves a specific version of a transactional template by its template ID and version ID.
- ReadRetrieve a subuser's branded linkRetrieve the branded link associated with a specific subuser.
- ReadRetrieve bounce classification totalsThis endpoint will return the total number of bounces by classification in descending order for each day.
- ReadRetrieve bounce purge mail settingsRetrieve your current Bounce Purge mail settings.
- ReadRetrieve click track settingsRetrieves your current click tracking settings from SendGrid.
- ReadRetrieve Current Enforced TLS SettingsRetrieve the current Enforced TLS settings for your SendGrid account.
- ReadRetrieve email statistics by browserRetrieve email statistics segmented by browser type (Chrome, Firefox, Safari, etc.).
- ReadRetrieve email statistics by client typeRetrieve email statistics segmented by client type (Webmail, Desktop, Phone, Tablet, Other).
- ReadRetrieve email statistics by device typeRetrieve email statistics segmented by device type (Desktop, Webmail, Phone, Tablet, Other).
- ReadRetrieve email statistics by mailbox providerRetrieve email statistics segmented by recipient mailbox provider (e.g., Gmail, Yahoo, Microsoft Outlook).
- ReadRetrieve email statistics for categoriesRetrieve email statistics for specific categories within a date range.
- ReadRetrieve email statistics for your subusersRetrieves email statistics for specified subusers over a date range.
- ReadRetrieve footer mail settingsRetrieve your current Footer mail settings from SendGrid.
- ReadRetrieve forward bounce mail settingsRetrieves the current forward bounce mail settings for your SendGrid account.
- ReadRetrieve forward spam mail settingsRetrieves the current forward spam mail settings for your SendGrid account.
- ReadRetrieve global email statisticsRetrieve global email statistics for your SendGrid account within a specific date range.
- ReadRetrieve Google Analytics SettingsRetrieves the current Google Analytics tracking settings for your SendGrid account.
- ReadRetrieve legacy template mail settingsRetrieves your current legacy email template mail settings.
- ReadRetrieve monthly stats for all subusersRetrieves monthly email statistics for all subusers.
- ReadRetrieve paged transactional templates**This endpoint allows you to retrieve all transactional templates.**
- ReadRetrieve recipientsRetrieve all marketing campaign recipients via this endpoint.
- ReadRetrieve recipients on a segmentRetrieves all recipients (contacts) in a specified segment from SendGrid's Legacy Marketing Campaigns Contact Database.
- ReadRetrieve reserved fields**Retrieve all reserved fields from the Legacy Marketing Campaigns Contact Database.** This endpoint returns a list of fields that are reserved by SendGrid and cannot be used as custom field names.
- ReadRetrieve scheduled sendRetrieve the cancel/pause status of a scheduled email batch by its batch_id.
- ReadRetrieves inbound parse webhook statisticsRetrieve statistics for emails processed by SendGrid's Inbound Parse Webhook.
- ReadRetrieve single segment endpointRetrieves detailed information about a specific Marketing Campaigns segment by its unique ID.
- ReadRetrieve specific teammateRetrieves details of a specific SendGrid teammate by username.
- ReadRetrieve stats by a specific client typeRetrieve email statistics for a specific client type (phone, tablet, webmail, or desktop).
- ReadRetrieve subscription tracking settingsRetrieves the current subscription tracking settings for your SendGrid account.
- ReadRetrieve subuser reputationsRetrieves sender reputation scores (0-100) for subusers.
- ReadRetrieve sums of email stats for each categoryRetrieve aggregated email statistics sums for each category over a date range.
- ReadRetrieve the count of billable recipients (Legacy)Retrieves the count of billable recipients for SendGrid Legacy Marketing Campaigns.
- ReadRetrieve the default branded linkRetrieves the default branded link for message sending.
- ReadRetrieve the lists that a recipient is onRetrieves all marketing campaign lists that a specific recipient belongs to.
- ReadRetrieve tracking settings**This endpoint allows you to retrieve a list of all tracking settings on your account.**
- ReadRetrieve User's Authenticated DomainsRetrieve authenticated domains (up to five) assigned to a specific subuser.
- ReadRetrieve your account email addressRetrieves the email address currently on file for your SendGrid account.
- ReadRetrieve your credit balanceRetrieves the current email credit balance for your SendGrid account.
- ReadRetrieve your usernameRetrieve your current SendGrid account username and user ID.
- ReadReturns a list of all partner settingsRetrieve a paginated list of all partner settings that can be enabled for your SendGrid account.
- ReadSearch contactsFind contacts using this endpoint with a body containing a `query` in SGQL.
- ReadSearch for suppressions within a group**This endpoint allows you to search a suppression group for multiple suppressions.** When given a list of email addresses and a group ID, this endpoint will only return the email addresses that…
- ReadSearch recipientsSearch for recipients in the Legacy Marketing Campaigns contact database by field value.
- ReadSum email stats for subusersRetrieves summed email statistics for all subusers over a date range.
- ReadTest an Event Webhook's SettingsSends a test event notification to a specified URL to verify your webhook endpoint is properly configured to receive SendGrid events.
- ReadValidate a batch IDValidate whether a mail batch ID exists in SendGrid's system.
- ReadValidate a branded link**This endpoint allows you to validate a branded link.** It checks that the required DNS CNAME records are correctly configured for your branded link domain.
- ReadValidate a domain authentication**This endpoint allows you to validate an authenticated domain.** It checks that the required DNS records are correctly configured for your sending domain.
- ReadValidate an emailValidates an email address and returns a verdict on its validity.
- ReadView a sender identityRetrieves the details of a specific Legacy Sender Identity by its unique ID.
- ReadView scheduled time of a campaignRetrieves the scheduled send date and time for a Legacy Marketing Campaign.
- WriteActivate template versionActivates a specific version of a transactional template, making it the default version used when sending emails. Approval by default
- WriteAdd a batch of ips to an ip poolAdds a batch of IP addresses to a specified IP Pool in SendGrid. Approval by default
- WriteAdd an ip address to a poolAdds a dedicated IP address to an IP pool in your SendGrid account. Approval by default
- WriteAdd an ip to an authenticated domainAdd an IP address to an authenticated domain for custom SPF configuration. Approval by default
- WriteAdd a twilio sendgrid ip addressProvisions a new Twilio SendGrid IP address to your account. Approval by default
- WriteAdd ipsAdd dedicated IP addresses to your SendGrid account. Approval by default
- WriteAdd one or more ips to the allow listAdds one or more IPv4 addresses to your SendGrid account's IP access management allow list. Approval by default
- WriteAdd or update a contactAdds or updates contacts in SendGrid Marketing Campaigns. Approval by default
- WriteAdd suppressions to a suppression group**This endpoint allows you to add email addresses to an unsubscribe group.** If you attempt to add suppressions to a group that has been deleted or does not exist, the suppressions will be added to… Approval by default
- WriteAdd recipient addresses to the global suppression groupAdds one or more email addresses to the global suppression group. Approval by default
- WriteApprove access request**This endpoint allows you to approve an access attempt.** **Note:** Only teammate admins may approve another teammate’s access request. Approval by default
- WriteAssign a batch of subusers to an ipAssigns multiple subusers to a specified IP address in a single operation. Approval by default
- WriteAssociate a branded link with a subuserAssociate a branded link with a subuser account for email link tracking. Approval by default
- WriteAssociate an authenticated domain with a given userAssociate an authenticated domain with a subuser, allowing the subuser to send emails using the parent account's domain authentication. Approval by default
- WriteAuthenticate a domainThe endpoint enables domain authentication for users or subusers, offering two methods—'username' parameter for visibility and modification, or the Association workflow for a fixed, non-editable… Approval by default
- WriteAuthenticate an account with single sign onGenerates a one-time SSO authentication URL for logging into a customer's Twilio SendGrid account. Approval by default
- WriteBind authenticated domains to userAssociates an additional authenticated domain with a subuser. Approval by default
- WriteBulk delete single sendsPermanently deletes multiple Single Sends in a single operation by providing their IDs. Approval by default
- WriteCancel or pause a scheduled sendCancel or pause a group of scheduled email sends by their batch_id. Approval by default
- WriteCreate a batch idGenerate a new mail batch ID to group multiple email sends together. Approval by default
- WriteCreate a branded linkCreate a new branded link by specifying the root domain, which must align with your FROM email, and an optional unique subdomain. Approval by default
- WriteCreate a campaignThis endpoint enables campaign creation, requiring a subject, sender ID, content (HTML and text suggested), and a list or segment ID for sending or scheduling, but not for initial creation. Approval by default
- WriteCreate a custom fieldCreates a custom field for storing additional contact information in SendGrid. Approval by default
- WriteCreate a listCreate a new contact list in SendGrid's Marketing Campaigns. Approval by default
- WriteCreate an accountCreates a new customer account under your organization using the Account Provisioning API. Approval by default
- WriteCreate a new alertCreate a new SendGrid alert. Approval by default
- WriteCreate a new event webhookSet up an Event Webhook by providing a URL, choosing events for POST requests, and receive a unique ID. Approval by default
- WriteCreate a new suppression groupCreate a new suppression group (unsubscribe group) to allow recipients to opt out of specific types of emails. Approval by default
- WriteCreate a new transactional template version**This endpoint allows you to create a new version of a template.** Approval by default
- WriteCreate an ip poolCreates a new IP pool in your SendGrid account. Approval by default
- WriteCreate an ip pool with a name and ip assignmentsCreates a new IP Pool in your SendGrid account using the IP Address Management API. Approval by default
- WriteCreate an sso certificateCreate an SSO certificate for SAML 2.0 Single Sign-On authentication. Approval by default
- WriteCreate an sso integrationCreate a new Single Sign-On (SSO) integration for your SendGrid account. Approval by default
- WriteCreate an sso teammateCreates a Single Sign-On (SSO) Teammate in SendGrid. Approval by default
- WriteCreate a parse settingCreates a new Inbound Parse Webhook setting to receive and parse incoming emails. Approval by default
- WriteCreate api keysCreates a new SendGrid API key with specified permissions. Approval by default
- WriteCreate a segmentCreates a new segment in SendGrid's Contact Database (Legacy Marketing Campaigns). Approval by default
- WriteCreate a senderCreates a new Sender identity for use in SendGrid Marketing Campaigns. Approval by default
- WriteCreate a sender identity**Create a new sender identity in SendGrid.** A sender identity is required to send email through SendGrid. Approval by default
- WriteCreate a transactional templateCreate a new transactional email template in SendGrid. Approval by default
- WriteCreate custom field definitionCreate unique case-insensitive custom fields with alphanumeric/underscore names starting with a letter/underscore. Approval by default
- WriteCreate designCreates a new email design in the SendGrid Design Library. Approval by default
- WriteCreate Marketing IntegrationCreate a SendGrid Marketing Integration for email event forwarding to Segment. Approval by default
- WriteCreate listCreate a new contact list in SendGrid Marketing Campaigns. Approval by default
- WriteCreate segmentCreates a new contact segment using SendGrid's Marketing Campaigns Segmentation V2 API. Approval by default
- WriteCreate single sendThe endpoint lets you create a Single Send draft without needing a template ID; it now uses `email_config`. Approval by default
- WriteCreate subuser**This endpoint allows you to create a new subuser.** Subusers allow you to segment your email sending and API activity. Approval by default
- WriteCreate verified sender requestThis endpoint creates a new sender identity via `POST`, sends a verification email to `from_email`, and requires email verification. Approval by default
- WriteDelete a batch of ips from an ip poolRemoves a batch of IP addresses from a specified IP Pool in SendGrid. Approval by default
- WriteDelete a batch of subusers from an ipRemoves multiple subusers from a specified IP address in a single batch operation. Approval by default
- WriteDelete a bounceRemoves an email address from your SendGrid bounce suppression list. Approval by default
- WriteDelete a branded linkPermanently delete a branded link from your SendGrid account. Approval by default
- WriteDelete a campaignPermanently deletes a specific marketing campaign from your SendGrid account. Approval by default
- WriteDelete a contact identifierRemoves a specific identifier (EMAIL, PHONENUMBERID, EXTERNALID, or ANONYMOUSID) from a contact without deleting the entire contact. Approval by default
- WriteDelete a custom fieldPermanently deletes a custom field from your SendGrid contact database. Approval by default
- WriteDelete a global suppressionThis endpoint removes an email from suppressions, allowing future emails to be sent to it. Approval by default
- WriteDelete an accountPermanently deletes a customer account under your organization using the Account Provisioning API. Approval by default
- WriteDelete an alertDelete a SendGrid alert by its ID. Approval by default
- WriteDelete an authenticated domainDelete an authenticated domain (formerly known as domain whitelabel) by its ID. Approval by default
- WriteDelete an IP PoolDelete an IP pool by its name using the legacy IP Pools API. Approval by default
- WriteDelete an SSO CertificateDelete an SSO certificate by its unique identifier. Approval by default
- WriteDelete an SSO IntegrationDelete an SSO (Single Sign-On) integration by ID. Approval by default
- WriteDelete a parse settingDeletes a specific inbound parse webhook setting by hostname. Approval by default
- WriteDelete api keys**This endpoint allows you to revoke an existing API Key using an `api_key_id`** Authentications using a revoked API Key will fail after after some small propogation delay. Approval by default
- WriteDelete a reverse dns recordThis endpoint deletes a reverse DNS record, returning a 204 code on success. Approval by default
- WriteDelete a segmentPermanently deletes a segment from the SendGrid Contact Database (Legacy Marketing Campaigns). Approval by default
- WriteDelete a senderPermanently delete an existing Marketing Campaigns Sender identity from your SendGrid account. Approval by default
- WriteDelete a sender identityPermanently deletes a sender identity from your SendGrid account. Approval by default
- WriteDelete a single event webhook by idDelete a specific Event Webhook by ID with this endpoint. Approval by default
- WriteDelete a specific blockDeletes a specific email address from your SendGrid blocks list. Approval by default
- WriteDelete a specific invalid emailRemoves a specific email address from SendGrid's invalid emails suppression list. Approval by default
- WriteDelete a specific spam reportRemoves a specific spam report from SendGrid's suppression list by email address. Approval by default
- WriteDelete a subuserPermanently delete a subuser from your SendGrid account. Approval by default
- WriteDelete a suppression from a suppression groupRemove an email address from a suppression group (unsubscribe group). Approval by default
- WriteDelete a suppression groupThis API endpoint deletes email suppression groups. Approval by default
- WriteDelete a templatePermanently deletes a transactional template from your SendGrid account. Approval by default
- WriteDelete a transactional template version**Delete a specific version of a transactional template.** This endpoint permanently removes a template version. Approval by default
- WriteDelete blocksDelete blocked email addresses from your SendGrid suppression list. Approval by default
- WriteDelete bouncesDelete bounced email addresses from your SendGrid bounce suppression list. Approval by default
- WriteBulk Delete IntegrationsBulk delete multiple Integrations by providing their IDs as a query parameter. Approval by default
- WriteDelete a cancellation or pause from a scheduled sendResume a paused or cancelled scheduled send by removing its pause/cancel status. Approval by default
- WriteDelete contactsDeletes contacts from your SendGrid Marketing Campaigns account. Approval by default
- WriteDelete custom field definitionPermanently deletes a custom field definition from SendGrid Marketing Campaigns. Approval by default
- WriteDelete design**This endpoint allows you to delete a single design**. Approval by default
- WriteDelete invalid emailsDelete email addresses from your SendGrid invalid emails suppression list. Approval by default
- WriteDelete ip poolDelete an IP Pool from your SendGrid account using the IP Address Management API. Approval by default
- WriteDelete pending teammateDelete a pending teammate invitation that hasn't yet been accepted. Approval by default
- WriteDelete single send by idPermanently deletes a Single Send by its unique ID. Approval by default
- WriteDelete single send scheduleCancel a scheduled Single Send by deleting its scheduled send time. Approval by default
- WriteDelete spam reportsDelete spam reports from your SendGrid spam report suppression list. Approval by default
- WriteDelete teammatePermanently delete a teammate from your SendGrid account. Approval by default
- WriteDelete verified senderDeletes a Verified Sender Identity from your SendGrid account. Approval by default
- WriteDeny access requestDenies a teammate's pending access request. Approval by default
- WriteDisassociate a branded link from a subuserRemove a branded link association from a subuser account. Approval by default
- WriteDuplicate a transactional templateDuplicate an existing transactional template to create a new template with the same content. Approval by default
- WriteDuplicate designDuplicates an existing email design in the SendGrid Design Library. Approval by default
- WriteDuplicate sendgrid pre built designDuplicates a pre-built SendGrid email design template from the SendGrid Design Library. Approval by default
- WriteDuplicate Single SendDuplicates an existing Single Send by its ID, creating a new draft that can be edited via the Update Single Send endpoint (PATCH). Approval by default
- WriteEdit an SSO TeammateUpdates an existing SSO Teammate's permissions and profile in SendGrid. Approval by default
- WriteEdit a transactional templateUpdates the name of an existing transactional template. Approval by default
- WriteEdit a transactional template versionEdit a transactional template version in SendGrid. Approval by default
- WriteEdit verified senderUpdates an existing verified sender identity in SendGrid. Approval by default
- WriteEmail dns records to a co workerEmail DNS records to a co-worker for domain authentication or link branding setup. Approval by default
- WriteEnable disable a subuserEnable or disable a SendGrid subuser account. Approval by default
- WriteEnable disable website access for a subuserEnable or disable website portal access for a SendGrid subuser while preserving their email sending capabilities. Approval by default
- WriteErase recipients email dataPermanently erases recipients' personal email data from SendGrid for GDPR/privacy compliance. Approval by default
- WriteImport contactsInitiates a bulk contact import by requesting an upload URL for a CSV file. Approval by default
- WriteInvite teammateInvite teammates to your account through email with this endpoint, assigning initial permissions via the `scopes` array. Approval by default
- WriteManually refresh a segmentManually refresh a Marketing Campaigns V2 segment to update its contact membership. Approval by default
- WriteRequest Presigned URL for Bulk Email ValidationRequest a presigned URL and headers to upload a file containing email addresses for bulk validation. Approval by default
- WriteRemove an ip address from a poolRemove an IP address from an IP pool in your SendGrid account. Approval by default
- WriteRemove an ip from an authenticated domainRemove an IP address from an authenticated domain's custom SPF configuration. Approval by default
- WriteRemove a specific ip from the allowed listRemoves a specific IP address from your SendGrid account's allow list. Approval by default
- WriteRemove contacts from a listRemove contacts from a marketing list without deleting them from your account. Approval by default
- WriteRemove list and optional contactsDelete a marketing list from your SendGrid account. Approval by default
- WriteRemove one or more ips from the allow listRemoves one or more IP addresses from your SendGrid IP Access Management allow list. Approval by default
- WriteRemove segment without affecting contactsPermanently deletes a segment from SendGrid's Marketing Campaigns without affecting contacts. Approval by default
- WriteDisassociate an authenticated domain from a given userDisassociate ALL authenticated domains from a subuser. Approval by default
- WriteRename an ip poolRenames an existing IP pool in your SendGrid account. Approval by default
- WriteRequest csvInitiating a backend process creates a CSV file of up to 1 million events from the last 30 days, emailed to the user with a 3-day expiry link. Approval by default
- WriteResend a sender verificationResends the verification email for a Marketing Campaigns Sender identity. Approval by default
- WriteResend sender identity verificationResends the verification email to a sender identity's 'from' email address. Approval by default
- WriteResend teammate inviteResend a pending teammate invitation to refresh its expiration date. Approval by default
- WriteResend verified sender requestResends the verification email to a Sender Identity's 'from_email' address. Approval by default
- WriteSchedule a campaignSchedules a Legacy Marketing Campaigns email for delivery at a specific time. Approval by default
- WriteSchedule single sendSchedule a Single Send for immediate or future delivery. Approval by default
- WriteSend a campaignImmediately sends an existing marketing campaign to its configured recipients. Approval by default
- WriteSend a test marketing emailSend a test marketing email before launching a campaign. Approval by default
- WriteSend email with twilio sendgridThe Mail Send operation uses SendGrid's v3 API to send emails. Approval by default
- WriteSet up reverse dnsSet up reverse DNS (rDNS) for a dedicated IP address. Approval by default
- WriteStart warming up an ip addressPut a dedicated IP address into warmup mode. Approval by default
- WriteStop warming up an ip addressStop warming up a dedicated IP address and remove automatic sending limits. Approval by default
- WriteToggle signature verification for a single event webhook by idEnable or disable signature verification for a single Event Webhook by its ID. Approval by default
- WriteUnlink subuser domainDisassociate an authenticated domain from a subuser. Approval by default
- WriteUnschedule a scheduled campaignUnschedule a campaign that has already been scheduled to be sent. Approval by default
- WriteUpdate a branded linkUpdate a specific branded link's default status. Approval by default
- WriteUpdate a campaignUpdates an existing marketing campaign. Approval by default
- WriteUpdate account offeringsUpdates the offerings (email packages and add-ons) assigned to a customer account. Approval by default
- WriteUpdate address whitelist mail settingsUpdates the address whitelist mail settings for your SendGrid account. Approval by default
- WriteUpdate a listUpdates the name of an existing recipient list in the Marketing Campaigns. Approval by default
- WriteUpdate Account StateUpdate the state of a customer account using the Account Provisioning API. Approval by default
- WriteUpdate an alertUpdate an existing SendGrid alert's settings. Approval by default
- WriteUpdate an authenticated domainUpdates the settings for an authenticated domain in SendGrid. Approval by default
- WriteUpdate an IP Pool NameUpdates the name of an existing IP Pool in your SendGrid account. Approval by default
- WriteUpdate an SSO IntegrationUpdate an existing Single Sign-On (SSO) integration for your SendGrid account. Approval by default
- WriteUpdate a parse settingUpdates an existing Inbound Parse Webhook setting by hostname. Approval by default
- WriteUpdate API Key NameUpdates the name of an existing SendGrid API key. Approval by default
- WriteUpdate api key name and scopesUpdates both the name and permission scopes of an existing SendGrid API key. Approval by default
- WriteUpdate a scheduled campaignUpdates the scheduled send time for a Legacy Marketing Campaigns email. Approval by default
- WriteUpdate a scheduled sendUpdate the status of a scheduled send batch that already has a pause or cancel status. Approval by default
- WriteUpdate a segmentUpdates an existing segment in SendGrid's Marketing Campaigns using the Segmentation V2 API. Approval by default
- WriteUpdate a senderUpdates an existing Sender identity for use in SendGrid Marketing Campaigns. Approval by default
- WriteUpdate a sender identityUpdates an existing sender identity in SendGrid. Approval by default
- WriteUpdate a single event webhook by idUpdates the configuration of a specific Event Webhook by its ID. Approval by default
- WriteUpdate a suppression groupUpdates an existing suppression group (also known as an unsubscribe group). Approval by default
- WriteUpdate a User's ProfileUpdates the authenticated user's profile information in SendGrid. Approval by default
- WriteUpdate bounce purge mail settingsUpdate your Bounce Purge mail settings in SendGrid. Approval by default
- WriteUpdate click tracking settingsUpdates click tracking settings for your SendGrid account. Approval by default
- WriteUpdate custom field definitionUpdates the name of an existing custom field in SendGrid Marketing Contacts. Approval by default
- WriteUpdate designUpdates an existing email design in the SendGrid Design Library using PATCH. Approval by default
- WriteUpdate details for an ip addressUpdates settings for a dedicated IP address in your SendGrid account. Approval by default
- WriteUpdate enforced tls settingsUpdate the Enforced TLS settings for your SendGrid account. Approval by default
- WriteUpdate footer mail settingsUpdate your Footer mail settings in SendGrid. Approval by default
- WriteUpdate forward bounce mail settingsUpdates the forward bounce mail settings for your SendGrid account. Approval by default
- WriteUpdate forward spam mail settingsUpdates the Forward Spam mail settings for your SendGrid account. Approval by default
- WriteUpdate Google Analytics SettingsUpdates Google Analytics tracking settings for your SendGrid account. Approval by default
- WriteUpdate Marketing IntegrationUpdate an existing Marketing Integration by its unique ID. Approval by default
- WriteUpdate listUpdate the name of an existing contact list in SendGrid Marketing Campaigns. Approval by default
- WriteUpdate open tracking settingsUpdates open tracking settings for your SendGrid account. Approval by default
- WriteUpdate single sendUpdate a Single Send draft by its ID. Approval by default
- WriteUpdate SSO CertificateUpdate an existing SSO (Single Sign-On) certificate by its ID. Approval by default
- WriteUpdate subscription tracking settingsUpdates subscription tracking settings for your SendGrid account. Approval by default
- WriteUpdate Teammate's PermissionsUpdates a teammate's permissions in your SendGrid account. Approval by default
- WriteUpdate template mail settingsUpdates the legacy email template mail settings for your SendGrid account. Approval by default
- WriteUpdate the credits for a subuserUpdate the credit allocation settings for a SendGrid Subuser. Approval by default
- WriteUpdate the remaining credits for a subuserUpdates the remaining credits for a specific Subuser account by adding or subtracting from the current credit balance. Approval by default
- WriteUpdate your account email addressUpdates the email address currently on file for your SendGrid account. Approval by default
- WriteUpdate your passwordUpdate the password for your SendGrid account. Approval by default
- WriteUpdate your usernameUpdate the username for your SendGrid account. Approval by default
- WriteValidate a reverse dns recordValidate a reverse DNS (rDNS) record to check if DNS is properly configured. Approval by default
- WriteVerify sender requestVerifies a sender identity using a token from the verification email. Approval by default
One prompt, start to finish
What a governed SendGrid run looks like inside Luumen.
Questions
How does LuumenAI connect to SendGrid?
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in SendGrid on its own?
Read actions answer immediately. Anything that writes — activate template version, add a batch of ips to an ip pool, add an ip address to a pool, add an ip to an authenticated domain, and more — is shown as a plan and requires approval by default, including the 61 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to SendGrid — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
SlackRead the incident thread; post updates and approvals back.
GmailVendor and alert mail as context; replies drafted for review.
Microsoft TeamsRead Teams channels and chats for context, then make membership changes as approved steps.
DiscordRead Discord command permissions and app context, then change them with approvalPut SendGrid to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.