Learn how to prepare a Mailgun domain, connect it with a Private API key, activate Mailgun for Agency-level sending, understand sub-account provider priority, validate the connection, and troubleshoot common setup issues.

Chat To Clients CRM uses the Mailgun Private API key for this integration. Treat the key as a secret and never expose it in screenshots, support tickets, documentation, or public messages.

Connecting Mailgun lets Chat To Clients CRM use your Mailgun account and verified sending domain for outbound email.

The Private API key authenticates Chat To Clients CRM with Mailgun and allows eligible verified domains from the account to be selected during setup. After saving the service, you must set it as Active before it becomes the Agency-level default.

Connecting your own Mailgun account gives your agency more control over the infrastructure used for applicable Chat To Clients CRM email while keeping provider management centralized.

• Use Your Own Infrastructure: Send through your existing Mailgun account and verified domain.
• Centralize Agency Setup: Use Mailgun as the default service for sub-accounts without their own provider.
• Switch Providers: Save multiple Agency-level email services and change which service is Active when needed.
• Support Sub-Account Overrides: Allow individual sub-accounts to use another provider when configured.
• Support Reply Routing: Proper Mailgun receiving and DNS configuration can route supported replies back into Conversations.

Preparing Mailgun before connecting it prevents the most common issues with missing domains, authentication failures, and unexpected provider behavior.

Before you begin:

• Have an active Mailgun account.
• Have at least one verified Mailgun sending domain or subdomain.
• Create the Mailgun domain in the US region.
• Complete the DNS records required for your Mailgun configuration.
• Have access to Agency View → Settings → Email Services.
• Have the appropriate Mailgun Private API key.

Keep these limitations in mind:

• Chat To Clients CRM reads eligible verified Mailgun domains from the US region.
• Saving a Mailgun service does not automatically make it Active.
• Only one Agency-level email service can be Active at a time.
• A sub-account-specific provider takes priority over the Agency-level provider.
• Inbound reply handling requires additional Mailgun receiving and DNS configuration.
• Mailgun billing, volume limits, and provider-level restrictions are managed through Mailgun.

Chat To Clients CRM can display eligible Mailgun domains only when the domain is verified and configured in the supported Mailgun region.

• Create the Mailgun domain or subdomain in the US region, not the EU region.
• Confirm the domain shows as verified in Mailgun.
• Complete the DNS records required by your Mailgun configuration.
• Use a subdomain when you want Mailgun sending to remain separate from the primary domain's existing mailbox configuration.

Connecting Mailgun at the Agency level makes it available as the default sending service for eligible sub-accounts after the service is saved and activated.

Step 1: Copy Your Mailgun Private API Key

The Private API key authenticates the connection between Chat To Clients CRM and the Mailgun account containing your verified sending domain.

1. Sign in to Mailgun.
2. Go to Settings → API Keys.
3. Create a key if you do not already have an appropriate Private API key.
4. Copy the key securely.

Step 2: Open Agency Email Services

Agency Email Services control the default sending provider used when a sub-account does not have its own email provider configured.

1. Open Agency View.
2. Click Settings.
3. Select Email Services.
4. Open the SMTP Service tab.

Step 3: Add Mailgun

Add Mailgun as an Agency-level Email Service and select the verified sending domain associated with the Mailgun account.

1. Click + Add Service.
2. In the Add your own email service window, select Mailgun.
3. Enter your Mailgun API Key.
4. Select the verified Mailgun Domain.
5. Save the Email Service.

Step 4: Set Mailgun as Active

Saving the service adds Mailgun to your Agency account, but the Agency does not use it as the default provider until you activate it.

1. Locate the Mailgun service you added.
2. Click Set as Active.
3. Confirm the change.
   
   
   

Provider priority determines which Email Service actually sends email when both Agency-level and sub-account-specific configurations exist.

If a sub-account has its own provider configured, that provider takes precedence. If it does not, Chat To Clients CRM uses the applicable Agency-level Active provider.

To review sub-account provider assignments, go to:

Agency View → Settings → Email Services → Location Settings

Agencies can also control whether sub-accounts are allowed to add their own Email Services from:

Agency View → Settings → Email Services → Advanced Settings

Testing Mailgun after activation confirms that the expected provider and sending domain work before you depend on the configuration for campaigns, workflows, or regular conversations.

1. Confirm Mailgun shows as Active under Agency View → Settings → Email Services.
2. Confirm the expected verified Mailgun domain is selected.
3. Open a sub-account that should use the Agency-level provider.
4. Create or open a test contact using an email address you can access.
5. Send a test email from the contact conversation.
6. Confirm the message is received.
7. Reply to the email if you also want to test inbound reply handling.
8. Confirm the reply appears in Conversations.

Most Mailgun connection issues come from domain verification, region selection, API authentication, provider priority, or inbound-routing configuration.

The API key cannot retrieve domains

• Confirm you are using the Mailgun Private API key.
• Confirm the key belongs to the expected Mailgun account.
• Confirm the key has not been deleted, replaced, or revoked.
• If Mailgun IP restrictions prevent Chat To Clients CRM from retrieving domain information, temporarily adjust the restriction, retry the connection, and restore the restriction after validation.

Related Articles

•  How to Add Your Own Email Service (MailGun) in Agency 
•  Mailgun: Private API Key Setup 
•  Step-by-Step Guide to Set Up Mailgun 
•  Cold Email Inbound Setup Mailgun 
•  How to Setup Replies in MailGun 
•  New Agency-Level Control for Email SMTP Services