SendGrid
API integration

list_all_sendgrid_teammates

Get a list of all current teammates in SendGrid. Returns teammates' username, email, first_name, last_name, user_type, and is_admin fields. Use limit and offset to control pagination.

get_single_sendgrid_teammate_by_id

Get information about a specific teammate by id in SendGrid. Returns username, first_name, last_name, email, scopes, user_type, is_admin, phone, website, company, address, address2, city, state, country, and zip.

create_a_sendgrid_teammate

Invite a new teammate by email in SendGrid. Requires email, scopes array for permissions, and isAdmin boolean to set admin status. Invitation expires after 7 days but can be resent to reset expiration.

delete_a_sendgrid_teammate_by_id

Delete a teammate by username in SendGrid. Requires the username as id. Only the parent user or an admin teammate can perform this action.

update_a_sendgrid_teammate_by_id

Update a teammate's permissions by username in SendGrid. Requires is_admin boolean and scopes array. If is_admin is true, scopes must be empty. Only parent user or admin teammates can perform this update.

update_a_sendgrid_api_key_by_id

Update the name and scopes of an API key in SendGrid by id. Returns the api_key_id, name, and scopes fields in the response.

list_all_sendgrid_api_keys

Get all API keys for the authenticated user in SendGrid. Returns each key's name and id. Note: API keys themselves cannot be retrieved after creation.

get_single_sendgrid_api_key_by_id

Get a single API key by id in SendGrid. Returns the key's name, id, and scopes. Returns 404 if the api_key_id does not exist.

create_a_sendgrid_api_key

Create a new API Key in SendGrid with a required name. Returns the unique API key ID and other key details. Note: Maximum 100 keys allowed; omitting scopes grants Full Access by default.

delete_a_sendgrid_api_key_by_id

Revoke an existing API Key in SendGrid using api_key_id. Returns 404 if the api_key_id does not exist. Revoked keys will fail authentication after a short propagation delay.

list_all_sendgrid_me

Get the current user's profile in SendGrid. Returns address, city, company, country, first_name, last_name, phone, state, website, and zip fields.

list_all_sendgrid_teammate_subuser

Get Subusers accessible by a specified Teammate in SendGrid using teammate_name. Returns subuser id, username, email, disabled status, permission_type, and scopes.

list_all_sendgrid_pending_teammates

Get a list of all pending teammate invitations in SendGrid. Returns email, scopes, is_admin status, pending_id, and expiration_date for each invitation.

create_a_sendgrid_pending_teammate

Resend a teammate invitation in SendGrid using token. Resending resets the 7-day expiration. Response includes pending_id, email, scopes, and is_admin fields.

delete_a_sendgrid_pending_teammate_by_id

Delete a pending teammate invite in SendGrid using the token.

list_all_sendgrid_teammates_access_requests

Get a list of recent access requests in SendGrid. Returns id, scope_group_name, username, email, first_name, and last_name for each request.

update_a_sendgrid_teammates_access_request_by_id

Approve an access attempt for a teammate access request in SendGrid using id. Only teammate admins may approve another teammate’s access request. The response confirms the approval.

delete_a_sendgrid_teammates_access_request_by_id

Delete a teammate access request by id in SendGrid to deny an attempt to access your account. Only teammate admins may perform this action.

list_all_sendgrid_alerts

Get all alerts in SendGrid. Returns alert id, type, email, percentage for usage_limit alerts, frequency for stats_notification alerts, createdAt and updatedAt timestamps.

get_single_sendgrid_alert_by_id

Get a specific alert by id in SendGrid. Returns fields id, created_at (timestamp), updated_at (timestamp), email_to (recipient email), frequency (notification frequency), and type (alert type).

create_a_sendgrid_alert

Create a new alert in SendGrid with type and email. For stats_notification, frequency is required; for usage_limit, percentage is required. Returns the created alert details.

update_a_sendgrid_alert_by_id

Update an alert by id in SendGrid. Returns the updated alert with fields email, frequency, and percentage reflecting the new alert settings.

delete_a_sendgrid_alert_by_id

Delete an alert by id in SendGrid.

list_all_sendgrid_scheduled_sends

Get all cancelled and paused scheduled sends in SendGrid. Returns scheduled sends associated with a batch_id, including batch_id and status fields.

get_single_sendgrid_scheduled_send_by_id

Get cancel or paused scheduled send information for a specific batch_id in SendGrid. Returns batch_id and status fields indicating the scheduled send status.

update_a_sendgrid_scheduled_send_by_id

Update the status of a scheduled send identified by id in SendGrid. The status can be set to 'cancel' or 'pause'. Updating status after using the cancel or pause endpoint results in a 400 error.

delete_a_sendgrid_scheduled_send_by_id

Delete the cancellation or pause of a scheduled send in SendGrid using id. Note: Scheduled sends cancelled less than 10 minutes before the scheduled time may not be cancelled.

sendgrid_scheduled_sends_cancel_pause

Cancel or pause a scheduled send by batch_id in SendGrid. Requires batch_id and status (pause or cancel). Returns confirmation of the updated status. Note: Cannot update if already paused or cancelled; max cancellations/pauses limit applies.

list_all_sendgrid_account

Get all accounts under the organization in SendGrid. Returns account id and createdAt timestamp for each account.

create_a_sendgrid_account

Create a new account with specified offerings in SendGrid.

delete_a_sendgrid_account_by_id

Delete a specific account by id in SendGrid. This irreversible action revokes API keys and SSO, removes offerings and resources, and cancels billing immediately.

sendgrid_account_single_sign_on

Authenticate and log in a user to Twilio SendGrid as a specific admin identity configured for SSO by partner using accountID. Note: Additional teammates or subusers must log in directly via app.sendgrid.com.

get_single_sendgrid_account_state_by_id

Get the state of the specified account in SendGrid. Requires account id. Returns the account state such as activated, deactivated, suspended, banned, or indeterminate.

update_a_sendgrid_account_state_by_id

Update the state of the specified account in SendGrid. Requires id and state with possible values 'activated' or 'deactivated'.

list_all_sendgrid_offering

Get offerings available under the organization in SendGrid. Returns catalog array with offering details including name, type, quantity, and entitlements such as email_sends_max_monthly, ip_count, teammates_max_total, and users_max_total.

get_single_sendgrid_offering_by_id

Get offering information for the specified account in SendGrid. Requires account id. Returns offerings array with fields: name, type (package or addon), and quantity.

update_a_sendgrid_offering_by_id

Change package and add-on offerings for the specified account in SendGrid. Requires account id and offerings list with name, type (package or addon), and quantity (1 for package).

list_all_sendgrid_authenticated_domains

Get a paginated list of all authenticated domains in SendGrid. Returns fields including domain details and authentication status.

get_single_sendgrid_authenticated_domain_by_id

Get a specific authenticated domain by id in SendGrid. Returns domain details including domain name, authentication status, and associated DNS records.

create_a_sendgrid_authenticated_domain

Create an authenticated domain in SendGrid with domain parameter. Returns domain details including domain, subdomain, username, ips, custom_spf, default, automatic_security, custom_dkim_selector, and region.

update_a_sendgrid_authenticated_domain_by_id

Update settings for an authenticated domain in SendGrid using id. Returns updated domain settings including default status and custom SPF configuration.

delete_a_sendgrid_authenticated_domain_by_id

Delete an authenticated domain by id in SendGrid.

sendgrid_authenticated_domains_validate

Validate an authenticated domain by id in SendGrid. Returns an error message if the domain validation fails.

list_all_sendgrid_default_authentication

Get the default authentication domain details in SendGrid. Returns the default domain and its details if set, or general domain authentication status if no default is set.

create_a_sendgrid_domain_ip

Add an IP address to an authenticated domain in SendGrid. Requires id and ip. Returns confirmation of the IP association with the domain.

delete_a_sendgrid_domain_ip_by_id

Delete an IP address from the domain authentication in SendGrid. Requires id and ip. This removes the specified IP from the domain's whitelabel configuration.

list_all_sendgrid_subuser_domain_association

Get all authenticated domains assigned to a specific subuser in SendGrid. Requires username. Returns domain details including domain name and association status.

get_single_sendgrid_subuser_domain_association_by_id

Get all authenticated domains assigned to a specific subuser in SendGrid. Requires username. Returns domain details including domain name, id, and associated subuser.

create_a_sendgrid_subuser_domain_association

Associate an authenticated domain with a subuser in SendGrid. Requires domain_id and username. This allows the subuser to send mail using the parent's authenticated domain.

delete_a_sendgrid_subuser_domain_association_by_id

Delete the association of an authenticated domain from a subuser in SendGrid. Requires the username of the subuser to disassociate the domain.

list_all_sendgrid_email_address_validation

Get a list of all Bulk Email Validation Jobs in SendGrid. Returns job details including job ID, status, and creation date.

get_single_sendgrid_email_address_validation_by_id

Get a specific Bulk Email Validation Job by id in SendGrid. Returns job status and details to check progress.

create_a_sendgrid_email_address_validation

Validate an email address in SendGrid. Requires the email address to be provided in the request body. Returns validation results including email validity status.

sendgrid_email_address_validation_upload

Create an email validation job in SendGrid by uploading a list of email addresses. Requires file_type parameter specifying the format (csv or zip). Returns upload_uri and upload_headers for file upload.

create_a_sendgrid_email_dn

Send DNS record information email to a colleague in SendGrid using link_id and domain_id to provide records for Link Branding and Domain Authentication. Requires email and IDs.

list_all_sendgrid_ip_address

Get a paginated list of all assigned and unassigned IPs in SendGrid. Returns IP address, warm up status, pools, assigned subusers, and reverse DNS info.

sendgrid_ip_address_pools

Get IP pools for a specific IP address in SendGrid. Requires id as the IP address. Returns the list of IP pools the IP address belongs to.

sendgrid_ip_address_assigned

Get assigned IP addresses in SendGrid. Returns IP addresses dedicated to the account with their reputation based on aggregate sender performance.

sendgrid_ip_address_remaining

Get the amount of IP addresses that can still be created and their price in SendGrid.

list_all_sendgrid_ip_address_management

Get a list of all IP addresses associated with your SendGrid account. Returns IP details including Pools, auto warmup status, and last updated time.

get_single_sendgrid_ip_address_management_by_id

Get details for a specified IP address in SendGrid. Requires ip. Returns fields including assignment status, warmup setting, associated Pools, added and modified dates, lease status, and enabled status.

create_a_sendgrid_ip_address_management

Create a new IP address in SendGrid with is_auto_warmup and is_parent_assigned settings. Returns the created IP address details including region if include_region is true.

update_a_sendgrid_ip_address_management_by_id

Update settings for an IP address in SendGrid using id. Requires at least one of is_auto_warmup, is_parent_assigned, or is_enabled. Returns updated IP address settings including these fields.

list_all_sendgrid_ip_pools

Get all IP pools in SendGrid. Returns a list of IP pools with their names and associated IP addresses.

create_a_sendgrid_ip_pool

Create an IP pool in SendGrid. Requires the name of the new IP pool. The response returns the created pool's details including its name.

update_a_sendgrid_ip_pool_by_id

Update the name of an IP pool in SendGrid using pool_name. Returns the updated pool name.

delete_a_sendgrid_ip_pool_by_id

Delete an IP pool by pool_name in SendGrid. Requires pool_name as id.

list_all_sendgrid_ip_warmup

Get all IP addresses currently warming up in SendGrid. Returns details of each warming up IP address.

get_single_sendgrid_ip_warmup_by_id

Get the warmup status for a specific IP address in SendGrid. Requires id as the IP address. Returns warmup status details.

create_a_sendgrid_ip_warmup

Put an IP address into warmup mode in SendGrid. Provide the IP address in the request body under the 'ip' property.

delete_a_sendgrid_ip_warmup_by_id

Remove an IP address from warmup mode in SendGrid. Requires ip_address. Returns 204 status code on success.

list_all_sendgrid_link_branding

Get all branded links in SendGrid. Returns an array of branded link objects with details such as id, domain, and subdomain.

get_single_sendgrid_link_branding_by_id

Get a specific branded link by id in SendGrid. Returns details of the branded link including its configuration and status.

create_a_sendgrid_link_branding

Create a new branded link in SendGrid with the required domain. Optionally include subdomain, default status, and region. Returns the created link branding details including domain and subdomain.

update_a_sendgrid_link_branding_by_id

Update a specific branded link by id in SendGrid. Allows changing the branded link's default status. Requires id.

delete_a_sendgrid_link_branding_by_id

Delete a branded link by id in SendGrid. Returns a 204 status code on successful deletion. Note: The response does not include link details; retrieve them before deletion if needed.

list_all_sendgrid_reverse_dns

Get a list of all Reverse DNS records in SendGrid. Supports filtering by ip prefix using the ip parameter. Returns fields including ip, domain, and associated whitelabel information.

get_single_sendgrid_reverse_dn_by_id

Get a reverse DNS record by id in SendGrid. Returns the reverse DNS record details associated with the specified id.

create_a_sendgrid_reverse_dn

Create reverse DNS for an IP address in SendGrid. Requires ip and domain. Optionally include subdomain. Returns confirmation of the reverse DNS setup.

delete_a_sendgrid_reverse_dn_by_id

Delete a reverse DNS record by id in SendGrid. Returns a 204 status code on successful deletion.

sendgrid_reverse_dns_validate

Validate a reverse DNS record by id in SendGrid. Returns the valid status and reason if validity cannot be determined.

list_all_sendgrid_sender_verification

Get all Sender Identities associated with an account in SendGrid. Returns both verified and unverified senders. Supports filtering by id to return a specific Sender Identity.

create_a_sendgrid_sender_verification

Create a new sender identity in SendGrid with required fields nickname, from_email, and reply_to. Returns sender details including nickname, from_email, and verification status. Verification email is sent to from_email.

update_a_sendgrid_sender_verification_by_id

Update an existing Sender Identity in SendGrid by id. Returns the updated sender identity including nickname, from_email, reply_to, and address details.

delete_a_sendgrid_sender_verification_by_id

Delete a Sender Identity by id in SendGrid. This removes the specified Sender Identity from your account.

sendgrid_sender_verification_resend

Resend a verification email to the from_address of a specified Sender Identity in SendGrid using id.

sendgrid_sender_verification_verify

Get verification status of a sender using the token in SendGrid. Requires token as id. Returns verification result indicating if the sender is verified.

list_all_sendgrid_engagement_quality_scores

Get SendGrid Engagement Quality scores for the date range from and to. Returns positive and negative feedback scores for the specified period.

sendgrid_engagement_quality_scores_subusers

Get SendGrid Engagement Quality scores for subusers on a specific date using datestring. Returns scores including positive and negative feedback counts.

list_all_sendgrid_design

Get a list of existing designs in SendGrid. Returns design id, name, and updated_at fields for each design.

get_single_sendgrid_design_by_id

Get information about a specific design in SendGrid. Requires id. Returns design details including stored fields for potential updates.

create_a_sendgrid_design

Create a new design in SendGrid with required html_content. Returns design details including name, editor, html_content, and plain_content.

update_a_sendgrid_design_by_id

Edit a design by id in SendGrid. Update fields like name, html_content, plain_content, generate_plain_content, subject, and categories. Returns the updated design object with these fields.

delete_a_sendgrid_design_by_id

Delete a single design by id in SendGrid. This action is permanent and requires the design id.

sendgrid_design_duplicate

Duplicate an existing design by id in SendGrid. Optionally set a new name and editor type. Returns the duplicated design's unique id and details.

list_all_sendgrid_prebuilt_design

Get a list of pre-built designs from SendGrid. Returns design IDs and summary fields by default.

get_single_sendgrid_prebuilt_design_by_id

Get details about a specific pre-built design in SendGrid using id. Returns fields describing the design for duplication and modification.

sendgrid_prebuilt_design_duplicate

Duplicate a pre-built design in SendGrid by specifying id. Optionally rename the duplicate with the name field. Returns the duplicated design's unique id and name.

list_all_sendgrid_messages

Get filtered email activity messages in SendGrid using query. Returns messages with fields like email details and status. Requires query parameter.

get_single_sendgrid_message_by_id

Get all details about the specified message in SendGrid. Requires msg_id as id. Returns message fields including status, subject, sender, recipient, and timestamps.

create_a_sendgrid_csv

Create a CSV file of message events from the last 30 days in SendGrid. The CSV contains up to 1 million events and a download email link is sent. The link expires in 3 days. The querystring parameter filters included messages.

sendgrid_csv_download

Get a presigned URL to download the CSV file for the given download_uuid in SendGrid. The download_uuid is the UUID provided in the email when the CSV file is ready. Returns the presigned_url to access the CSV.

list_all_sendgrid_tracking_settings

Get a list of all tracking settings in SendGrid. Returns fields name, title, description, and enabled status for each setting.

get_single_sendgrid_click_tracking_by_id

Get current click tracking setting in SendGrid. Returns click tracking status and configuration details to understand how users engage with your email links.

update_a_sendgrid_click_tracking_by_id

Update click tracking setting in SendGrid. Requires 'enabled' boolean to enable or disable click tracking. Response returns the current click tracking status.

get_single_sendgrid_google_analytics_tracking_by_id

Get the current Google Analytics tracking settings in SendGrid. Returns fields including campaign tracking status and UTM parameters configuration.

update_a_sendgrid_google_analytics_tracking_by_id

Update Google Analytics tracking settings in SendGrid. Returns the updated settings including enabled status and UTM parameters: utm_campaign, utm_content, utm_medium, utm_source, and utm_term.

get_single_sendgrid_open_tracking_by_id

Get current open tracking settings in SendGrid. Returns settings including whether open tracking is enabled and configuration details.

update_a_sendgrid_open_tracking_by_id

Update the current settings for open tracking in SendGrid. Requires the enabled boolean to set the new status. Returns the open_tracking object reflecting the updated settings.

get_single_sendgrid_subscription_tracking_by_id

Get current subscription tracking settings in SendGrid. Returns subscription tracking configuration including enable status and substitution tag.

update_a_sendgrid_subscription_tracking_by_id

Update subscription tracking settings in SendGrid. Returns the updated subscription tracking configuration including enabled status, html_content, landing page HTML, plain_content, replacement tag, and unsubscribe URL.

list_all_sendgrid_global_statistics

Get global email statistics for the date range start_date to end_date in SendGrid. Returns aggregated stats including metrics like requests, delivered, opens, clicks, bounces, and spam reports.

list_all_sendgrid_browser_statistics

Get email statistics segmented by browser type in SendGrid. Requires start_date. Returns stats including browser name, metrics like clicks, opens, and sends. Data stored up to 7 days.

list_all_sendgrid_client_statistics

Get email statistics segmented by client type in SendGrid. Returns up to 7 days of email activity with key fields including client type and email actions.

sendgrid_client_statistics_client_type

Get email statistics for a specific client_type in SendGrid from start_date. Returns stats including email activity counts segmented by client type. Data is limited to the last 7 days.

list_all_sendgrid_geo_statistics

Get email statistics segmented by country and state/province in SendGrid. Requires start_date. Returns statistics including metrics by geographic location for up to 7 days.

list_all_sendgrid_device_statistics

Get email statistics segmented by device type in SendGrid. Requires start_date. Returns device type, metrics, and timestamps. Data is stored for up to 7 days.

list_all_sendgrid_mailbox_providers

Get email statistics segmented by recipient mailbox provider in SendGrid. Requires start_date and optionally end_date. Returns stats including counts of emails sent, delivered, and engagement metrics.

list_all_sendgrid_event_webhooks

Get all Event Webhooks in SendGrid. Returns an array of webhooks with configuration details and id.

get_single_sendgrid_event_webhook_by_id

Get a single Event Webhook by id in SendGrid. Returns fields including webhook configuration and optionally account_status_change if included.

create_a_sendgrid_event_webhook

Create a new Event Webhook in SendGrid by providing the URL to receive event data. Returns webhook configuration including enabled status, event types subscribed, friendly_name, and OAuth settings if configured.

update_a_sendgrid_event_webhook_by_id

Update a single Event Webhook by id in SendGrid. Requires url to set the webhook destination. Returns updated webhook including enabled status, event types subscribed, and friendly_name.

delete_a_sendgrid_event_webhook_by_id

Delete a single Event Webhook by id in SendGrid. Requires the id of the webhook to delete. This endpoint returns an error if id is not provided to prevent unintentional deletions.

sendgrid_event_webhooks_test

Test an Event Webhook by sending a fake event notification to the specified url in SendGrid. Requires url in the request body. Optional id, oauth_client_id, oauth_client_secret, and oauth_token_url can be included for OAuth configuration.

sendgrid_event_webhooks_toggle_signature

Enable or disable signature verification for a single Event Webhook by id in SendGrid. Returns the public_key if enabled or an empty string if disabled.

list_all_sendgrid_inbound_parse_settings

Get all current inbound parse settings in SendGrid. Returns an array of settings including url (POST destination), hostname (domain for parsing), spam_check (spam filtering enabled), and send_raw (original MIME content included).

get_single_sendgrid_inbound_parse_setting_by_id

Get a specific inbound parse setting by hostname in SendGrid. Returns details of the inbound parse setting associated with the hostname.

create_a_sendgrid_inbound_parse_setting

Create a new inbound parse setting in SendGrid with url and hostname. Returns the created setting details including url, hostname, spam_check, and send_raw flags.

update_a_sendgrid_inbound_parse_setting_by_id

Update a specific inbound parse setting by hostname in SendGrid. Requires hostname. Returns updated settings including url, hostname, spam_check, and send_raw fields.

delete_a_sendgrid_inbound_parse_setting_by_id

Delete a specific inbound parse setting by hostname in SendGrid. Requires hostname as id.

list_all_sendgrid_parse_security_policies

Get a list of all webhook security policies configured for your account in SendGrid. Returns policy IDs, names, and security configurations.

get_single_sendgrid_parse_security_policy_by_id

Get details of a specific webhook security policy by id in SendGrid. Returns fields including policy id, name, and settings.

create_a_sendgrid_parse_security_policy

Create a new webhook security policy in SendGrid. Requires either signature or oauth in the request body to form a valid security policy. Returns the created security policy details including name and configuration.

update_a_sendgrid_parse_security_policy_by_id

Update an existing webhook security policy by id in SendGrid. Returns updated policy fields including names, oauth configuration, and signature settings.

delete_a_sendgrid_parse_security_policy_by_id

Delete a webhook security policy by id in SendGrid.

list_all_sendgrid_contacts

Get up to 50 of the most recent contacts in SendGrid. Returns contact details including id, email, first_name, last_name, phone_number, list_ids, segment_ids, created_at, updated_at, and total contact_count.

get_single_sendgrid_contact_by_id

Get full details and all fields for a specific contact in SendGrid using id. Returns complete contact information.

create_a_sendgrid_contact

Upsert up to 30,000 contacts in SendGrid with at least one identifier (email, phone_number_id, external_id, or anonymous_id). Returns job_id to check processing status. Custom fields must be pre-created.

delete_a_sendgrid_contact_by_id

Delete one or more contacts in SendGrid. Requires either ids as a comma-separated list of contact IDs or delete_all_contacts set to "true" to delete all contacts. Deletion is processed asynchronously.

get_single_sendgrid_contacts_import_by_id

Get the status of a contact import job in SendGrid using id. Returns job status (pending, completed, errored, failed) and results object with job-specific fields. Use errors_url file for error details if any.

create_a_sendgrid_contacts_import

Import contacts by uploading a CSV file with field_mappings in SendGrid. Returns upload_uri and upload_headers for file upload. Requires file_type as 'csv' and at least one identifier in the CSV.

list_all_sendgrid_contacts_exports

Get details of all current exported jobs in SendGrid. Returns an array of export jobs with fields id, status, created_at, completed_at, expires_at, urls (download links if ready), user_id, export_type, segments, and lists.

get_single_sendgrid_contacts_export_by_id

Get the status of a contact export job in SendGrid using id. Returns URLs to download CSV files of exported contacts.

create_a_sendgrid_contacts_export

Create an export of contact lists or segments in SendGrid. Specify list_ids or segment_ids to export. The response returns an id to track the export status and retrieve download URLs.

list_all_sendgrid_contacts_search

Search contacts using an SGQL query string in SendGrid. Returns up to 50 contacts matching the query with fields including email, created_at, and updated_at.

sendgrid_contacts_search_identifier

Search up to 100 contacts by identifier_type and identifiers in SendGrid. Returns matching contacts with fields like contact details. Requires identifier_type and identifiers array.

sendgrid_contacts_search_emails

Search contacts by emails in SendGrid. Requires emails array. Returns matching contacts with fields including email and alternate_emails. Returns 404 if no contacts found and 400 if any email is invalid.

sendgrid_contacts_search_batch

Retrieve a set of contacts by their ids in SendGrid. Requires a request body with up to 100 ids. Returns contact details for the specified ids.

list_all_sendgrid_custom_fields

Get all defined Custom Fields and Reserved Fields in SendGrid.

create_a_sendgrid_custom_field

Create a new custom field definition in SendGrid with name and field_type. The name must be unique case-insensitively, start with a letter or underscore, and contain only alphanumeric characters or underscores. Returns the id of the created field.

update_a_sendgrid_custom_field_by_id

Update a defined Custom Field in SendGrid using id. Only custom fields can be modified; reserved fields cannot be updated. Returns the updated field_definition with the new name.

delete_a_sendgrid_custom_field_by_id

Delete a defined Custom Field in SendGrid. Only Custom Fields can be deleted; Reserved Fields cannot be deleted. Requires id.

list_all_sendgrid_lists

Get all contact lists in SendGrid. Returns an array of lists with details including list id and name.

get_single_sendgrid_list_by_id

Get data about a specific list in SendGrid by id. Returns list details including full contact count and, if contact_sample=true, up to 50 recent contacts attached to the list.

create_a_sendgrid_list

Create a new contacts list in SendGrid with the required name. Returns metadata including a link to the newly created list.

update_a_sendgrid_list_by_id

Update the name of a list in SendGrid. Requires id and a JSON body with the new name. Returns the updated list details.

delete_a_sendgrid_list_by_id

Delete a specific list by id in SendGrid. Optionally delete associated contacts by setting delete_contacts=true. Returns no content.

list_all_sendgrid_contact_list

Get the number of contacts on a specific list in SendGrid. Requires id. Returns contact_count indicating the total contacts on the list.

delete_a_sendgrid_contact_list_by_id

Remove contacts from a specific contact list in SendGrid. Requires id of the list and contact_ids as a comma separated list of contact IDs to remove. Contacts are not deleted, only removed from the list.

list_all_sendgrid_single_send_stats

Get stats for all Single Sends in SendGrid. Returns fields including id, ab_variation, ab_phase, aggregation, and stats metrics such as bounces, clicks, delivered, opens, and unsubscribes.

get_single_sendgrid_single_send_stat_by_id

Get detailed stats for a Single Send by id in SendGrid. Returns fields including id, ab_variation, ab_phase, aggregation, and stats metrics such as bounces, clicks, delivered, opens, spam reports, and unsubscribes.

create_a_sendgrid_single_send_stat

Export Single Send stats as CSV data in SendGrid. You can specify multiple Single Send ids as a comma-separated list in the ids query parameter. The response is plain text CSV format.

sendgrid_single_send_stats_click_tracking

Get click-tracking stats for a Single Send in SendGrid by id. Returns URLs embedded in the Single Send and the number of clicks each received.

list_all_sendgrid_automation_stats

Get stats for all Automations in SendGrid. Returns automation IDs, stats data, and pagination metadata. Use automation_ids to filter by specific automations.

get_single_sendgrid_automation_stat_by_id

Get stats for a single Automation by id in SendGrid. Returns detailed stats including step_id grouping, aggregated_by time slices, and date range filtering with key fields like metrics and timestamps.

create_a_sendgrid_automation_stat

Export Single Send stats as CSV data in SendGrid. Supports filtering by ids (Single Send IDs). The response is plain text CSV format.

sendgrid_automation_stats_click_tracking

Get click-tracking stats for a single Automation in SendGrid by id. Returns URLs embedded in the Automation and the number of clicks each received.

list_all_sendgrid_segmenting_contacts

Get a list of segments in SendGrid filtered by ids, parent_list_ids, or no_parent_list_id. Returns segment id, name, and parent_list_id fields.

get_single_sendgrid_segmenting_contact_by_id

Get a single segment by id in SendGrid. Returns segment details including id, name, and optionally the parsed SQL AST as query_json if requested.

delete_a_sendgrid_segmenting_contact_by_id

Delete a segment by id in SendGrid. Deleting a segment does not remove contacts associated with it; contacts remain in your list and other segments.

list_all_sendgrid_single_send

Get all Single Sends in SendGrid. Returns condensed details including Single Sends' IDs.

get_single_sendgrid_single_send_by_id

Get details about a specific Single Send in SendGrid using id. Returns fields including Single Send configuration and status.

create_a_sendgrid_single_send

Create a new Single Send in SendGrid with the required name. Returns the Single Send's id, name, and status. Note: This creates a draft that is not sent or scheduled until updated with the Schedule Single Send endpoint or UI.

update_a_sendgrid_single_send_by_id

Update a draft Single Send by id in SendGrid. Returns updated Single Send fields including name, categories, send_at, send_to details, and email_config settings. Note: send_at prepopulates send date but does not schedule sending.

delete_a_sendgrid_single_send_by_id

Delete a Single Send by id in SendGrid. This operation permanently removes the Single Send and it cannot be recovered.

sendgrid_single_send_duplicate

Duplicate an existing Single Send by id in SendGrid. Returns the duplicated Single Send details including the new name, which is 'Copy of ' plus the original name if no name is provided.

sendgrid_single_send_search

Search Single Sends by name, status, or categories in SendGrid. Returns fields including id, name, status, and categories for each matching Single Send.

sendgrid_single_send_bulk_delete

Delete multiple Single Sends by providing an array of Single Send ids in SendGrid. Deletion is permanent and Single Sends cannot be recovered.

list_all_sendgrid_single_send_categories

Get all categories associated with Single Sends in SendGrid. Returns up to the latest 1,000 categories.

create_a_sendgrid_schedule_single_send

Schedule or send immediately a Single Send in SendGrid by specifying the send_at time in ISO 8601 format or 'now'. Requires id and send_at. The response confirms scheduling status.

delete_a_sendgrid_schedule_single_send_by_id

Cancel a scheduled Single Send using the id in SendGrid. This request cancels the scheduled sending but does not delete the Single Send itself.

list_all_sendgrid_integrations

Get all integrations for the user in SendGrid. Returns integration_id, user_id, filters with email_events, properties including write_key and destination_region, label, and destination.

get_single_sendgrid_integration_by_id

Get information about a specific integration in SendGrid. Requires id. Returns integration details including configuration and status.

create_a_sendgrid_integration

Create an Integration for email event forwarding in SendGrid with destination, filters.email_events, and properties including write_key and destination_region. Returns the created integration details.

update_a_sendgrid_integration_by_id

Update an existing Integration in SendGrid by id. Returns the updated integration including label, destination, filters.email_events, and properties.write_key fields.

delete_a_sendgrid_integration_by_id

Delete an integration by id in SendGrid.

list_all_sendgrid_senders

Get a list of all Senders in SendGrid. Returns sender id, nickname, from email and name, reply_to email and name, physical address, verification status, lock status, and timestamps.

get_single_sendgrid_sender_by_id

Get details for a specific Sender by id in SendGrid. Returns sender's id, nickname, from email, from name, reply-to email, and address information.

create_a_sendgrid_sender

Create a new Sender in SendGrid with required fields nicknames, from.email, from.name, reply_to.email, address, city, and country. The response returns the created sender details including verification status.

update_a_sendgrid_sender_by_id

Update an existing Sender by id in SendGrid. Returns updated sender fields including nickname, from email and name, reply_to email and name, and physical address details. Updates to from.email require re-verification.

delete_a_sendgrid_sender_by_id

Delete an existing Sender by id in SendGrid.

create_a_sendgrid_send_test_email

Send a test marketing email using SendGrid with required template_id and emails (up to 10). Include either sender_id or from_address. Returns confirmation of the test email send.

list_all_sendgrid_api_key_permissions

Get a list of all scopes assigned to the API key used for authentication in SendGrid. Returns the scopes array representing permissions granted to the key.

get_single_sendgrid_enforced_tl_by_id

Get current Enforced TLS settings in SendGrid. Returns require_tls and require_valid_cert fields indicating if TLS 1.1+ or a valid certificate is required for recipients.

update_a_sendgrid_enforced_tl_by_id

Update Enforced TLS settings in SendGrid. Set require_tls to true to require TLS from recipients. If require_tls or require_valid_cert is true, recipients must support TLS 1.1+ or have a valid certificate. Returns updated enforced_tls settings including require_tls, require_valid_cert, and version.

list_all_sendgrid_ip_access_management

Get a list of all IP addresses that recently attempted to access your account in SendGrid. Returns fields including ip, allowed status, auth_method, first_at, last_at, and location.

list_all_sendgrid_ip_access_activity

Get a list of IP addresses allowed to access your account in SendGrid. Returns id, ip, created_at, and updated_at for each IP address.

get_single_sendgrid_ip_access_activity_by_id

Get information about a specific allowed IP address by id in SendGrid. Returns details of the allowed IP including its rule_id.

create_a_sendgrid_ip_access_activity

Add one or more allowed IP addresses in SendGrid. Requires an array of IPs in the request body. Returns the list of added IPs with their assigned id.

delete_a_sendgrid_ip_access_activity_by_id

Delete a specific allowed IP address by id in SendGrid. Requires the id of the IP address to remove it from the whitelist.

sendgrid_ip_access_activity_remove_multiple_ips

Remove one or more IP addresses from the allow list in SendGrid by providing an array of IP address IDs. Removing your own IP address will block account access and requires a support ticket to restore.

list_all_sendgrid_mail_settings

Get a list of all mail settings in SendGrid. Returns each setting's title, enabled status, name, and description.

get_single_sendgrid_address_whitelist_setting_by_id

Get current email address whitelist settings in SendGrid. Returns the whitelist that specifies email addresses or domains exempt from suppression such as bounces, blocks, and unsubscribes.

update_a_sendgrid_address_whitelist_setting_by_id

Update email address whitelist settings in SendGrid. Use 'enabled' to enable or disable the whitelist. Provide 'list' to overwrite the whitelist entries with specific email addresses or domains. Returns the updated whitelist settings.

get_single_sendgrid_bounce_purge_setting_by_id

Get current Bounce Purge mail settings in SendGrid. Returns maximum age for contacts in hard and soft bounce suppression lists, which determines deletion of contacts older than configured age.

update_a_sendgrid_bounce_purge_setting_by_id

Update Bounce Purge mail settings in SendGrid to configure maximum age for contacts in hard and soft bounce suppression lists. Returns enabled status, soft_bounces, and hard_bounces fields.

get_single_sendgrid_forward_bounce_setting_by_id

Get current bounce forwarding mail settings in SendGrid. Returns 'email' set to receive forwarded bounces and 'enabled' status indicating if the setting is active.

update_a_sendgrid_forward_bounce_setting_by_id

Update the bounce forwarding mail settings in SendGrid. Requires 'enabled' to indicate if forwarding is active and 'email' for the bounce report destination address.

get_single_sendgrid_forward_spam_setting_by_id

Get current Forward Spam mail settings in SendGrid. Returns the enabled status and email addresses set to receive forwarded spam.

update_a_sendgrid_forward_spam_setting_by_id

Update Forward Spam mail settings in SendGrid. Set the email addresses to forward spam reports and enable or disable the setting. Returns the updated forward_spam settings including email and enabled status.

get_single_sendgrid_footer_setting_by_id

Get current Footer mail settings in SendGrid. Returns footer settings including custom HTML or plain text inserted at the bottom of email message bodies.

update_a_sendgrid_footer_setting_by_id

Update the current Footer mail settings in SendGrid. Requires enabled, html_content, and plain_content to set the custom footer for email messages.

get_single_sendgrid_template_setting_by_id

Get current legacy email template settings in SendGrid. Returns the template settings that wrap an HTML template around your email content for marketing or HTML formatted messages.

update_a_sendgrid_template_setting_by_id

Update the legacy email template settings in SendGrid. Allows enabling the template and setting new HTML content. Returns the updated template settings including enabled status and html_content.

list_all_sendgrid_partner_settings

Get a paginated list of all partner settings available to enable in SendGrid. Returns partner_settings array with details of each setting.

delete_a_sendgrid_email_data_erase_by_id

Delete recipients' personal email data in SendGrid by providing a list of unique email_addresses. Returns any invalid email addresses in the error response. Maximum 5,000 addresses or 256Kb payload per request.

list_all_sendgrid_subusers

Get a paginated list of all subusers in SendGrid. Returns subuser usernames and other details depending on include_region flag.

create_a_sendgrid_subuser

Create a new subuser in SendGrid with required usernames, email, password, and assigned IP addresses. Returns subuser details including username, email, and assigned IPs.

update_a_sendgrid_subuser_by_id

Update the assigned IP addresses for a subuser in SendGrid. Requires subuser name as id and an array of IPv4 addresses in the request body.

delete_a_sendgrid_subuser_by_id

Delete a subuser by subuser_name in SendGrid. This is a permanent action and the subuser cannot be retrieved after deletion.

sendgrid_subusers_enable_disable

Update the disabled status of a subuser in SendGrid. Requires subuser_name as id and a boolean disabled field in the request body indicating if the subuser is enabled or disabled.

sendgrid_subusers_enable_disable_website

Enable or disable website access for a Subuser in SendGrid using subuser_name as id. The response confirms the updated disabled status indicating if website access is enabled or disabled.

get_single_sendgrid_subuser_credit_by_id

Get Credits overview for a Subuser in SendGrid. Requires subuser name as id. Returns credits details for the specified subuser.

update_a_sendgrid_subuser_credit_by_id

Update the Credits for a Subuser in SendGrid. Requires subuser_name as id. Returns updated credit information.

sendgrid_subuser_credits_remaining_credits

Update the remaining credits for a Subuser in SendGrid by specifying subuser_name as id and allocation_update to adjust credits.

list_all_sendgrid_subusers_stats

Get email statistics for the given subusers in SendGrid. Requires subusers and start_date. Returns stats including metrics like requests, delivered, opens, clicks, bounces, and blocks.

list_all_sendgrid_subusers_stats_monthly

Get monthly email statistics for all subusers in SendGrid for the given datestring. Returns stats including blocks, bounces, clicks, delivered, opens, requests, unique_clicks, unique_opens, and unsubscribes. Cannot sort by bounce_drops, deferred, invalid_emails, processed, spam_report_drops, spam_reports, or unsubscribe_drops.

get_single_sendgrid_subusers_stats_monthly_by_id

Get monthly email statistics for a specific subuser in SendGrid using subuser_name and datestring. Returns metrics including blocks, bounces, clicks, delivered, opens, requests, unique_clicks, unique_opens, and unsubscribes.

get_single_sendgrid_user_account_by_id

Get user account details in SendGrid. Returns account type and reputation fields.

update_a_sendgrid_user_email_address_by_id

Update the email address currently on file for your account in SendGrid. Provide the new email address in the request body under the 'email' field.

get_single_sendgrid_user_email_address_by_id

Get the email address currently on file for your account in SendGrid. Returns the email field containing the user's email address.

get_single_sendgrid_user_username_by_id

Get the current account username in SendGrid.

update_a_sendgrid_user_username_by_id

Update the username for your account in SendGrid. Provide the new username in the request body under 'username'.

get_single_sendgrid_user_credit_by_id

Get the current credit balance for your account in SendGrid. Returns the credits field indicating the base number of emails available before per-email charges apply.

update_a_sendgrid_user_password_by_id

Update your password in SendGrid by providing old_password and new_password. Returns no content on success.

list_all_sendgrid_sso_certificates

Get all IdP certificates for a specific integration in SendGrid using integration_id. Returns certificate details associated with the integration.

get_single_sendgrid_sso_certificate_by_id

Get an individual SSO certificate by id in SendGrid. Returns certificate details including certificate data and metadata.

create_a_sendgrid_sso_certificate

Create an SSO certificate in SendGrid with required public_certificate and integration_id. Returns the created certificate details including its enabled status.

update_a_sendgrid_sso_certificate_by_id

Update an existing SSO certificate by id in SendGrid. The response includes the updated certificate details such as public_certificate, enabled status, and integration_id.

delete_a_sendgrid_sso_certificate_by_id

Delete an SSO certificate by id in SendGrid.

list_all_sendgrid_sso_integrations

Get all SSO integrations tied to your Twilio SendGrid account. Returns integration details and includes completed_integration field if siboolean is true.

get_single_sendgrid_sso_integration_by_id

Get SSO integration by id in SendGrid. Returns integration details including id, name, and optionally completed_integration if siboolean is true.

create_a_sendgrid_sso_integration

Create an SSO integration in SendGrid with required fields name, enabled, signin_url, signout_url, and entity_id. Returns the created integration details including completion status.

update_a_sendgrid_sso_integration_by_id

Modify an existing SSO integration in SendGrid by id. Requires name, enabled, signin_url, signout_url, and entity_id. Optionally include siboolean to return completed_integration field.

delete_a_sendgrid_sso_integration_by_id

Delete an IdP configuration by id in SendGrid.

create_a_sendgrid_sso_teammate

Create an SSO Teammate in SendGrid with required email, first_name, and last_name. The email is the username and cannot be changed after creation. Returns the created Teammate details including email, first_name, last_name, and permissions.

update_a_sendgrid_sso_teammate_by_id

Update an existing SSO Teammate by username in SendGrid. Requires username as id, first_name, and last_name. Optional admin status, persona, scopes, restricted subuser access, and subuser access details can be set. Returns updated teammate details.

list_all_sendgrid_blocks

Get a list of blocked email addresses in SendGrid filtered by optional start_time, end_time, limit, offset, and email parameters. Returns email and created timestamp fields.

get_single_sendgrid_block_by_id

Get information about a specific blocked email address in SendGrid. Requires the email address as id. Returns details about the blocked email.

delete_a_sendgrid_block_by_id

Delete blocked email addresses in SendGrid by specifying emails or setting delete_all to true to remove all blocked emails.

sendgrid_blocks_specific

Delete a specific email address from your blocks list in SendGrid. Requires the email address as id.

list_all_sendgrid_bounces

Get a list of all bounces in SendGrid. Supports filtering by start_time and end_time (unix timestamps) and email prefix matching. Returns bounce details including email and created time.

get_single_sendgrid_bounce_by_id

Get information about a specific bounce by email in SendGrid. Requires email as id.

delete_a_sendgrid_bounce_by_id

Delete bounced emails in SendGrid. Use delete_all=true to remove all emails or specify emails array to delete selected emails. Both parameters cannot be used together.

sendgrid_bounces_bounced_email

Remove an email address from the bounce list in SendGrid. Requires the email address as id.

sendgrid_bounces_classification

Get total number of bounces by classification for each day in SendGrid. Returns date and stats with classification and count fields. Supports optional start_dates and end_dates parameters in YYYY-MM-DD format.

sendgrid_bounces_specific_classification

Get the number of bounces for the classification specified in descending order for each day in SendGrid. Requires classification. Returns daily counts of bounces filtered by classification.

list_all_sendgrid_invalid_emails

Get a list of invalid email addresses in SendGrid filtered by optional start_time and end_time. Returns invalid_emails array with details of each invalid email address.

get_single_sendgrid_invalid_email_by_id

Get information about a specific invalid email address in SendGrid. Requires email as id. Returns details about the invalid email entry.

delete_a_sendgrid_invalid_email_by_id

Delete invalid email addresses in SendGrid by specifying emails or setting delete_all to true to remove all invalid emails.

list_all_sendgrid_spam_reports

Get a list of spam reports in SendGrid. Supports filtering by start_time, end_time, limit, offset, and email. Returns spam report records including email and created timestamp.

get_single_sendgrid_spam_report_by_id

Get a specific spam report by email in SendGrid. Requires the email parameter as id. Returns details of the spam report associated with the email.

delete_a_sendgrid_spam_report_by_id

Delete spam reports by specifying emails or setting delete_all to true in SendGrid. This removes suppression and allows emails to be sent again to those addresses.

sendgrid_spam_reports_specific

Delete a specific spam report by email in SendGrid. Requires email. Deleting removes the suppression, allowing emails to be sent again to the previously suppressed address.

list_all_sendgrid_global_suppressions

Get a paginated list of all globally suppressed email addresses in SendGrid. Supports filtering by start_time and end_time timestamps. Returns email addresses that are globally unsubscribed.

get_single_sendgrid_global_suppression_by_id

Get global suppression for email in SendGrid. Returns the email if globally suppressed or an empty JSON object if not.

create_a_sendgrid_global_suppression

Add one or more email addresses to the global suppressions group in SendGrid. Requires recipient_emails array. Returns confirmation of added emails.

delete_a_sendgrid_global_suppression_by_id

Delete a global suppression for the email address in SendGrid to allow email delivery to the previously suppressed address.

list_all_sendgrid_suppressions

Get a list of all suppressions in SendGrid. Returns suppression details including email addresses and suppression reasons.

list_all_sendgrid_transactional_templates

Get all transactional templates with required page_size in SendGrid. Returns templates array with template id, name, generation, and versions.

get_single_sendgrid_transactional_template_by_id

Get a single transactional template by id in SendGrid. Returns template details including id, name, generation, and versions.

create_a_sendgrid_transactional_template

Create a transactional template in SendGrid with the required name. Returns the created template's id, name, generation, and updated_at fields.

update_a_sendgrid_transactional_template_by_id

Edit the name of a transactional template in SendGrid. Requires template id and new name. Returns updated template details including id and name.

delete_a_sendgrid_transactional_template_by_id

Delete a transactional template by id in SendGrid.

sendgrid_transactional_templates_duplicate

Create a duplicate of a transactional template in SendGrid using template_id. Returns the duplicated template details including the new template's id and name.