# Mailgun integration

> Transactional email API for sending, receiving, tracking, and analyzing email, plus domain, suppression, template, mailing-list, and account management.

- Authentication: apiKey

## Tools (295)

- **Activate Domain DKIM Key**: Activate a DKIM domain key for a domain after DNS verification.
- **Add Account IP Allowlist Entry**: Add a Mailgun account IP allowlist entry.
- **Add Allowlist Record**: Add an address or domain to a domain's allowlist.
- **Add Bounce**: Add one or many bounce records to a domain's bounce list.
- **Add Complaint**: Add one or many spam complaint records to a domain's complaint list.
- **Add IP to Dynamic IP Pool**: Add a dedicated IP to a specific Dynamic IP Pool.
- **Add IP to IP Pool**: Add a single dedicated IP to a dedicated IP pool (DIPP).
- **Add Mailing List Member**: Add a single member to a mailing list.
- **Add Multiple IPs to IP Pool**: Add multiple dedicated IPs to a dedicated IP pool (DIPP).
- **Add Multiple Mailing List Members (CSV)**: Bulk-upload members to a mailing list from a CSV file.
- **Add Multiple Mailing List Members (JSON)**: Bulk-add up to 1000 members to a mailing list via a JSON array.
- **Add Sandbox Authorized Recipient**: Add an authorized email recipient for a sandbox domain.
- **Add Unsubscribe**: Add one or many unsubscribe records to a domain's unsubscribe list.
- **Assign IP to All Domains**: Assign an IP to all account domains.
- **Assign IP to Band**: Place an account IP into a dedicated IP band.
- **Cancel IP Warmup**: Cancel the warmup plan for a dedicated IP address.
- **Copy Account Template**: Copies an account-level template into one or more new templates in target accounts.
- **Copy Account Template Version**: Copies an existing account-level template version into a new version.
- **Copy Domain Template**: Copies a domain template into one or more new templates in target accounts.
- **Copy Domain Template Version**: Copies an existing domain template version into a new version.
- **Create Account HTTP Signing Key**: Create or regenerate the webhook signing key on an account.
- **Create Account Template**: Stores a new account-level template, optionally with initial content that becomes the active version.
- **Create Account Template Version**: Adds a new version to an account-level template (up to 40 versions).
- **Create Account Webhook**: Create an account-level webhook for one or more event types.
- **Create Alert Event**: Create an alert setting that notifies a channel when an event occurs.
- **Create API Key**: Create a Mailgun API key.
- **Create Bulk Address Validation Job**: Submit a CSV list of addresses to run a bulk validation job.
- **Create Bulk Validation Preview**: Start a list health preview job that samples and validates a small percentage of a list.
- **Create DKIM Domain Key**: Create a new DKIM domain key or import an existing PEM key.
- **Create Domain**: Create a new sending domain.
- **Create Domain Template**: Stores a new template for a sending domain, optionally with initial content that becomes the active version.
- **Create Domain Template Version**: Adds a new version to a domain template (up to 40 versions).
- **Create Domain Webhook**: Create a domain webhook for a single event type.
- **Create Domain Webhooks (v4)**: Create a domain webhook URL for multiple event types (v4).
- **Create Forward**: Create a forward rule routing matching recipients to addresses, URLs, or storage.
- **Create IP Pool**: Create a new dedicated IP pool (DIPP) on the account.
- **Create IP Warmup**: Create a warmup plan for a dedicated IP address.
- **Create Limit Threshold**: Create a sending limit threshold that restricts pre-send feature consumption.
- **Create Mailing List**: Create a new mailing list.
- **Create Route**: Create a new route for handling incoming messages.
- **Create Send Alert**: Create a threshold-based send alert that notifies channels when a sending metric crosses a limit.
- **Create SMTP Credential**: Create Mailgun SMTP credentials for a given domain.
- **Create Subaccount**: Create a new subaccount.
- **Deactivate Domain DKIM Key**: Deactivate a DKIM domain key for a domain.
- **Delegate IP Pool to Subaccount**: Delegate a dedicated IP pool (DIPP) from the parent account to a subaccount.
- **Delegate IP Pool to Subaccount (v5)**: Initiate delegation of a dedicated IP pool to a subaccount.
- **Delete Account IP Allowlist Entry**: Delete a Mailgun account IP allowlist entry.
- **Delete Account Tag (Analytics)**: Delete an account tag via the analytics tags API.
- **Delete Account Template**: Deletes an account-level template and all of its versions.
- **Delete Account Template Version**: Deletes a specific version of an account-level template.
- **Delete Account Webhook by ID**: Delete a single account-level webhook by ID.
- **Delete Account Webhooks**: Delete account-level webhooks by ID or delete all.
- **Delete Alert Event**: Remove an alert setting by ID.
- **Delete Alert Slack Settings**: Remove the Slack integration settings for alerts.
- **Delete All Account Templates**: Deletes all account-level templates and their versions.
- **Delete All Allowlist Records**: Clear the entire allowlist for a domain.
- **Delete All Bounces**: Clear the entire bounce list for a domain.
- **Delete All Complaints**: Clear the entire spam complaint list for a domain.
- **Delete All Domain Templates**: Deletes all templates and their versions for a sending domain.
- **Delete Allowlist Record**: Remove a single entry from a domain's allowlist.
- **Delete All SMTP Credentials**: Delete all Mailgun SMTP credentials for a given domain.
- **Delete All Unsubscribes**: Clear the entire unsubscribe list for a domain.
- **Delete API Key**: Delete a Mailgun API key.
- **Delete Bounce**: Remove a single bounce record so delivery to the address can resume.
- **Delete Bulk Address Validation Job**: Cancel and delete a bulk address validation job by list ID.
- **Delete Bulk Validation Preview Job**: Delete a single list health preview (bulk validation preview) job by ID.
- **Delete Complaint**: Remove a single spam complaint record for an address.
- **Delete Custom Monthly Sending Limit**: Delete the custom monthly sending limit on the account.
- **Delete DKIM Domain Key**: Permanently delete a DKIM domain key by signing_domain and selector.
- **Delete Domain**: Delete a domain from the account.
- **Delete Domain Tag**: Delete a tag associated with a domain.
- **Delete Domain Template**: Deletes a domain template and all of its versions.
- **Delete Domain Template Version**: Deletes a specific version of a domain template.
- **Delete Domain Webhook by Type**: Delete a webhook event type (all its URLs) on a domain.
- **Delete Domain Webhooks (v4)**: Delete domain webhook URLs from all event types (v4).
- **Delete Forward**: Delete a forward rule by its ID.
- **Delete Inbox Placement Result**: Delete an inbox placement test result and all associated information.
- **Delete Inbox Placement Seed List**: Delete an inbox placement seed list and its results by address.
- **Delete IP Pool**: Delete a dedicated IP pool (DIPP), optionally relinking its domains to a replacement.
- **Delete Limit Threshold**: Delete a sending limit threshold by name.
- **Delete Mailing List**: Delete a mailing list by its address.
- **Delete Mailing List Member**: Remove a member from a mailing list.
- **Delete Route**: Delete a route by its ID.
- **Delete Sandbox Authorized Recipient**: Remove an authorized sandbox domain email recipient.
- **Delete Scheduled Messages**: Delete all scheduled and undelivered messages from a domain's queue.
- **Delete Send Alert**: Delete a threshold-based send alert by name.
- **Delete SMTP Credential**: Delete Mailgun SMTP credentials for a given domain and SMTP user.
- **Delete Subaccount**: Delete a subaccount identified by the on-behalf-of header.
- **Delete Subaccount Custom Monthly Limit**: Delete the custom monthly sending limit on a subaccount.
- **Delete Unsubscribe**: Remove a single unsubscribe record, re-subscribing the address.
- **Disable Subaccount**: Disable a subaccount.
- **Enable Subaccount**: Enable a subaccount.
- **Enroll All Domains in Dynamic IP Pools**: Start an async job to enroll all account domains in Dynamic IP Pools.
- **Enroll Domain in Dynamic IP Pools**: Enroll a domain in the Dynamic IP Pools feature.
- **Generate Inbox Placement Seed List**: Generate a new inbox placement seed list of seed addresses.
- **Generate Tracking Domain TLS Certificate**: Generate a TLS certificate for a tracking domain.
- **Get Account Domains Total Stats**: Get stat totals for account domains at a single time resolution.
- **Get Account HTTP Signing Key**: Get the webhook signing key saved on the account.
- **Get Account IP**: Get details about a specific account IP address.
- **Get Account IP Spillover Settings**: Get the DIPP spillover settings for the account.
- **Get Account Tag Limit (Analytics)**: Get the tag limit and current unique tag count for an account.
- **Get Account Template**: Returns metadata for an account-level template, optionally including its active version content.
- **Get Account Template Version**: Retrieves the information and content of a specific version of an account-level template.
- **Get Account Total Stats**: Get stat totals aggregated across an entire account.
- **Get Account Webhook by ID**: Get a single account-level webhook by ID.
- **Get Alert Settings**: Retrieve all configured alert settings for an account.
- **Get Alert Slack Channel**: Retrieve details for a specific Slack channel by ID.
- **Get Allowlist Record**: Return a single allowlist record by its address or domain value.
- **Get Available IP Count**: Return the number of IPs available to the account per its billing plan.
- **Get Bounce**: Return a single bounce record for a specific email address.
- **Get Bulk Address Validation Status**: Get the status and results of a bulk address validation job by list ID.
- **Get Bulk Validation Preview Job**: Get a single list health preview (bulk validation preview) job by ID.
- **Get Complaint**: Return a single spam complaint record for a specific email address.
- **Get Country Aggregate Stats**: Get aggregate event counts by country for a domain.
- **Get Current User**: Get one's own user details.
- **Get Custom Monthly Sending Limit**: Fetch the details of the custom sending limit on the account.
- **Get Device Aggregate Stats**: Get aggregate event counts by device for a domain.
- **Get Domain**: Get details about a single domain.
- **Get Domain IP Spillover Settings**: Get the DIPP spillover settings used for a specific domain.
- **Get Domain Tag**: Get a single tag associated with a domain.
- **Get Domain Tag Limit**: Get tag limit information for a domain.
- **Get Domain Template**: Returns metadata for a domain template, optionally including its active version content.
- **Get Domain Template Version**: Retrieves the information and content of a specific version of a domain template.
- **Get Domain Total Stats**: Get stat totals for an entire domain.
- **Get Domain Tracking Settings**: Get open, click, and unsubscribe tracking status for a domain.
- **Get Domain Webhook by Type**: Get the URLs for a specific webhook event type on a domain.
- **Get Filtered Account Stats**: Get filtered and grouped stat totals for an entire account.
- **Get Forward**: Retrieve a single forward rule by its ID.
- **Get Inbox Placement Result**: Get the details for a single inbox placement test result.
- **Get Inbox Placement Result Sharing Status**: Get the sharing status of an inbox placement result.
- **Get Inbox Placement Seed List**: Get a single inbox placement seed list by its address.
- **Get IP Pool**: Get details of a dedicated IP pool (DIPP).
- **Get IP Warmup**: Get the status of an in-flight IP warmup.
- **Get Limit Threshold**: Retrieve a single sending limit threshold by name.
- **Get Mailing List**: Retrieve a single mailing list by its address.
- **Get Mailing List Member**: Retrieve a single member of a mailing list.
- **Get Provider Aggregate Stats**: Get aggregate event counts by email service provider for a domain.
- **Get Route**: Retrieve a single route by its ID.
- **Get Send Alert**: Retrieve a single threshold-based send alert by name.
- **Get Sending Queues Status**: Get the status of a domain's regular and scheduled sending queues.
- **Get Shared Inbox Placement Result**: Get an inbox placement result by its public share ID.
- **Get Subaccount**: Get details of a single subaccount.
- **Get Subaccount Custom Monthly Limit**: Fetch the details of the custom sending limit on a subaccount.
- **Get Tag Stats**: Retrieve statistics for a specific tag on a domain.
- **Get Tag Stats Aggregates**: Get aggregate tag stats broken down by country, device, or provider.
- **Get Tracking Domain TLS Certificate Status**: Get the x509 TLS certificate and status for a tracking domain.
- **Get Unsubscribe**: Return a single unsubscribe record for a specific email address.
- **Get User**: Get a user's details on the account.
- **Import Allowlist Records**: Import a CSV file of allowlist records into a domain's allowlist.
- **Import Bounces**: Import a CSV file of bounce records into a domain's bounce list.
- **Import Complaints**: Import a CSV file of spam complaint records into a domain's complaint list.
- **Import Unsubscribes**: Import a CSV file of unsubscribe records into a domain's unsubscribe list.
- **List Account IP Allowlist**: List Mailgun account IP allowlist entries.
- **List Account IPs**: List the IP addresses assigned to the account.
- **List Account IPs Detailed**: List account and subaccount IPs with detailed, filterable records.
- **List Account Tags (Analytics)**: List or filter account tags via the analytics tags API.
- **List Account Templates**: Returns a paginated list of account-level templates available across all domains.
- **List Account Template Versions**: Returns a paginated list of versions of an account-level template.
- **List Account Threshold Hits**: List threshold alerts that have been triggered on an account.
- **List Account Webhooks**: List all account-level webhooks, optionally filtered by IDs.
- **List Alert Events**: List the event types available for alert configuration.
- **List Alert Slack Channels**: List Slack channels available in the connected workspace.
- **List All Bulk and Preview Validation Jobs**: Return all bulk validation and list health preview jobs for the account.
- **List Allowlist Records**: Fetch a paginated list of allowlist records for a domain.
- **List API Keys**: List Mailgun API keys.
- **List Assignable Dynamic IP Pool Domains**: List domains not yet enrolled in Dynamic IP Pools.
- **List Bounce Classification Bounce Logs**: List bounce log events for a domain.
- **List Bounce Classification Config Entities**: List bounce classification configuration entities.
- **List Bounce Classification Config Rules**: List bounce classification configuration rules.
- **List Bounce Classification Domain Entities**: List bounce classification statistics per entity for a domain.
- **List Bounce Classification Domains**: List per-account bounce classification statistics by domain.
- **List Bounce Classification Entity Rules**: List bounce classification statistics per rule for an entity.
- **List Bounce Classification Stats**: List bounce classification statistics ordered by total bounces.
- **List Bounces**: Fetch a paginated list of bounce records for a domain.
- **List Bulk Address Validation Jobs**: Return all bulk address validation jobs for the account.
- **List Bulk Validation Preview Jobs**: Return all list health preview (bulk validation preview) jobs.
- **List Complaints**: Fetch a paginated list of spam complaint records for a domain.
- **List DKIM Keys Across All Domains**: List DKIM keys across all domains with optional signing_domain/selector filters.
- **List DKIM Keys for a Domain**: List all DKIM keys for a specific domain.
- **List Domains**: List domains on the account, with filtering and pagination.
- **List Domains for IP**: List the account domains where a specific IP is assigned.
- **List Domain Tags**: List all tags associated with a domain.
- **List Domain Templates**: Returns a paginated list of templates stored for a sending domain.
- **List Domain Template Versions**: Returns a paginated list of versions of a domain template.
- **List Domain Webhooks**: List all webhooks configured for a domain.
- **List Dynamic IP Pool Account History**: Retrieve Dynamic IP Pool history records across the parent account and subaccounts.
- **List Dynamic IP Pool Domain History**: Retrieve a domain's Dynamic IP Pool history records.
- **List Dynamic IP Pool Domains**: List all domains assigned to Dynamic IP Pools across account and subaccounts.
- **List Dynamic IP Pools**: List all Dynamic IP Pools and their IPs.
- **List Events**: Retrieve a paginated list of message events for a domain.
- **List Forwards**: List all forward rules configured for the account.
- **List Inbox Placement Email Providers**: List all email providers available for inbox placement testing.
- **List Inbox Placement Result Attributes**: List the result attributes whose values can be enumerated for autocomplete.
- **List Inbox Placement Result Attribute Values**: List the known values for a given inbox placement result attribute.
- **List Inbox Placement Result Filters**: Get the list of filters available when querying inbox placement results.
- **List Inbox Placement Results**: List inbox placement test results with filtering and pagination.
- **List Inbox Placement Seed List Attributes**: List the seed list attributes whose values can be enumerated for autocomplete.
- **List Inbox Placement Seed List Attribute Values**: List the known values for a given inbox placement seed list attribute.
- **List Inbox Placement Seed List Filters**: Get the list of filters available when querying inbox placement seed lists.
- **List Inbox Placement Seed Lists**: List inbox placement seed lists with filtering and pagination.
- **List IP Pool Domains**: List domains linked to a dedicated IP pool (DIPP).
- **List IP Pools**: List all dedicated IP pools (DIPPs) on the account.
- **List IP Warmups**: List in-flight IP address warmup statuses.
- **List Limit Thresholds**: List all sending limit thresholds configured for an account.
- **List Mailing List Members**: Return the members of a mailing list.
- **List Mailing List Members by Page**: Paginate over the members of a mailing list.
- **List Mailing Lists**: Return the mailing lists under the account.
- **List Mailing Lists by Page**: Paginate over mailing lists using page cursors.
- **List Routes**: Fetch the list of all routes configured for the account.
- **List Sandbox Authorized Recipients**: Get authorized email recipients for a sandbox domain.
- **List Send Alerts**: List all threshold-based send alerts configured for an account.
- **List SMTP Credentials**: List Mailgun SMTP credential metadata for a given domain.
- **List Subaccount Delegated IP Pools**: List all subaccounts to which the parent account has delegated dedicated IP pools.
- **List Subaccounts**: List all subaccounts on the account.
- **List Supported Tag Countries**: Get a list of country codes that scout currently supports.
- **List Supported Tag Devices**: Get a list of devices that scout currently supports.
- **List Supported Tag Providers**: Get a list of providers that scout currently supports.
- **List Unsubscribes**: Fetch a paginated list of unsubscribe records for a domain.
- **List Users**: Get users on an account.
- **Match Route to Address**: Evaluate configured routes against a recipient address without mutating anything.
- **Override Dynamic IP Pool Domain Assignment**: Override a domain's Dynamic IP Pool assignment, pausing health-check updates.
- **Preview Dynamic IP Pool Domain Assignment**: Run a health check to preview which Dynamic IP Pool a domain would be placed in.
- **Promote Bulk Validation Preview Job**: Promote a running list health preview job to a full bulk validation job.
- **Query Bounce Classification Metrics**: Query bounce classification metrics with dimensions and filters.
- **Query Logs**: Query customer event logs for an account.
- **Query Metrics**: Query filtered sending metrics for an account.
- **Query Usage Metrics**: Query filtered usage metrics for an account.
- **Re-enable Account After Custom Limit**: Re-enable an account that was disabled for reaching the custom sending limit.
- **Regenerate Public API Key**: Regenerate the Mailgun Public API key.
- **Regenerate Tracking Domain TLS Certificate**: Regenerate an expired TLS certificate for a tracking domain.
- **Remove All Dynamic IP Pools**: Remove all Dynamic IP Pools from the account.
- **Remove Domain from Dynamic IP Pools**: Remove a domain from Dynamic IP Pools, assigning a replacement IP or pool.
- **Remove Dynamic IP Pool Domain Override**: Remove a domain's Dynamic IP Pool override, restoring health-check management.
- **Remove IP from All Domains**: Remove an IP from all account domains, optionally replacing it.
- **Remove IP from Domain**: Remove an IP from a domain pool, unlink a linked DIPP, or remove the domain pool.
- **Remove IP from Domain Pool**: Alternate endpoint to remove an IP from a domain pool, unlink a DIPP, or remove the pool.
- **Remove IP from IP Pool**: Remove a single IP from a dedicated IP pool (DIPP).
- **Rename Account Template**: Renames an account-level template.
- **Rename Domain Template**: Renames a domain template.
- **Request New Dedicated IP**: Add a new dedicated IP to the account.
- **Resend Account Activation Email**: Resend the account activation email to the account owner.
- **Resend Stored Message**: Resend a previously stored message to new recipients.
- **Reset Alert Webhook Signing Key**: Regenerate the signing key used to sign alert webhook requests.
- **Retrieve Stored Message**: Retrieve a previously stored message by its storage key.
- **Revoke Alert Slack OAuth Token**: Revoke the Slack OAuth access token used for alerts.
- **Revoke IP Pool from Subaccount**: Revoke delegation of a dedicated IP pool (DIPP) from a subaccount.
- **Revoke IP Pool from Subaccount (v5)**: Initiate revocation of a dedicated IP pool delegated to a subaccount.
- **Rotate Domain DKIM Key**: Immediately rotate a domain's Automatic Sender Security DKIM key.
- **Run Inbox Placement Test**: Create and run a new inbox placement (seed) test against seed list providers.
- **Send Message**: Send an email by submitting individual message components (form-encoded).
- **Send MIME Message**: Send a pre-built MIME-formatted email message.
- **Send Test Alert Email**: Send a test alert email with sample data to given addresses.
- **Send Test Alert Slack Message**: Send a test alert Slack message with sample data to channels.
- **Send Test Alert Webhook**: Send a test alert webhook with sample data to a URL.
- **Set Account IP Spillover Settings**: Set or modify the DIPP spillover pool for the account.
- **Set Custom Monthly Sending Limit**: Set a custom monthly sending limit on the account.
- **Set Domain IP Spillover Settings**: Set or modify the DIPP spillover pool used for a specific domain.
- **Set IPs for All Dynamic IP Pools**: Initialize or replace the IPs in all Dynamic IP Pools.
- **Set Subaccount Custom Monthly Limit**: Set a custom monthly sending limit on a subaccount.
- **Update Account Features**: Update account feature flags.
- **Update Account IP Allowlist Entry**: Update an individual Mailgun account IP allowlist entry's description.
- **Update Account Settings**: Update variable account settings such as organization name and session timeouts.
- **Update Account Tag (Analytics)**: Update an account tag's description via the analytics tags API.
- **Update Account Template**: Updates the description of an account-level template.
- **Update Account Template Version**: Updates the content or metadata of a specific account-level template version.
- **Update Account Webhook**: Update an account-level webhook by ID.
- **Update Alert Event**: Update an existing alert setting by ID.
- **Update Alert Slack Settings**: Configure the Slack integration used for alert delivery.
- **Update Domain**: Update configuration settings for a domain.
- **Update Domain Click Tracking**: Enable or disable click tracking for a domain.
- **Update Domain DKIM Authority**: Set whether a domain is its own DKIM authority or inherits from root.
- **Update Domain DKIM Key Rotation Settings**: Configure Automatic Sender Security DKIM key auto-rotation for a domain.
- **Update Domain DKIM Selector**: Update the DKIM selector for a domain.
- **Update Domain Open Tracking**: Enable or disable open tracking for a domain.
- **Update Domain Tag**: Update a tag associated with a domain.
- **Update Domain Template**: Updates the description of a domain template.
- **Update Domain Template Version**: Updates the content or metadata of a specific domain template version.
- **Update Domain Unsubscribe Tracking**: Enable or disable unsubscribe tracking and set footers for a domain.
- **Update Domain Webhook by Type**: Replace the URLs for a specific webhook event type on a domain.
- **Update Domain Webhooks (v4)**: Update a domain webhook URL's event-type associations (v4).
- **Update Dynamic IP Pool IPs**: Add and/or remove IPs from a specific Dynamic IP Pool.
- **Update Forward**: Update fields of an existing forward rule.
- **Update Inbox Placement Result Sharing Status**: Enable or disable sharing of an inbox placement result and create a public share URL.
- **Update Inbox Placement Seed List**: Update an inbox placement seed list, optionally regenerating its seed addresses.
- **Update IP Pool**: Edit a dedicated IP pool (DIPP): add/remove IPs, link/unlink domains, rename.
- **Update Limit Threshold**: Update an existing sending limit threshold's configuration.
- **Update Mailing List**: Update properties of an existing mailing list.
- **Update Mailing List Member**: Update an existing member of a mailing list.
- **Update Route**: Update fields of an existing route.
- **Update Send Alert**: Update an existing threshold-based send alert.
- **Update SMTP Credential**: Update Mailgun SMTP credentials for a given domain and SMTP user.
- **Update Subaccount Features**: Update subaccount feature flags.
- **Update Subaccount IP Assignments**: Link and/or unlink dedicated IPs to/from one or more subaccounts.
- **Validate Single Address**: Validate a single email address using the v4 email validation service.
- **Verify Domain**: Verify a domain's DNS records.

## Triggers (1)

- **New Email Event in Mailgun**: Triggers when Mailgun records a new message event (delivered, failed, opened, clicked, or complained) for the selected domain.

Connect Mailgun in General Input: https://www.generalinput.com/apps/mailgun