MailGun
Use this guide to set up the MailGun source connector and find reference information.
Prerequisites
You need an API key for this connector. Find it in the Mailgun dashboard under settings. Open the API Keys section, then click the eye icon beside Private API key See reference. Enter the generated API key to establish the connection.
Setup guide
Step 1: Set up the MailGun connection
- Generate an API key, for example, 12345.
- Add params if you need specific information.
- Available params:
- Domain Region Code: Domain region code. Possible values are ‘EU’ and ‘US’. The default is ‘US’.
- Replication Start Date: UTC date and time in the format 2020-10-01 00:00:00. Data before this date won’t be replicated. If omitted, this defaults to 90 days ago.
Step 2: Set up the MailGun connector in Airbyte
Airbyte Cloud
- Have a Log into your Airbyte Cloud account.
- Click Sources in the left navigation bar. Then click +new source in the top-right corner.
- On the Set up the source page, name the MailGun connector. Select MailGun from the Source type dropdown.
- Enter your api_key as
private_key. - Enter the optional params configuration if needed. Supported params are Domain Region Code and Replication Start Date.
- Click Set up source.
Airbyte OSS
- Open the Airbyte Open Source dashboard.
- Name your source.
- Enter your api_key as
pivate_key. - Enter the optional params configuration if needed. Supported params are Domain Region Code and Replication Start Date.
- Click Set up source.
Supported sync modes
The MailGun source connector supports these sync modes:
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental Sync | Yes |
| Replicate Incremental Deletes | No |
| SSL connection | Yes |
| Namespaces | No |
Supported streams
- domains
- events
API method example
GET https://api.mailgun.net/v3/domains
Performance considerations
MailGun’s API reference currently has v3, while v4 is in development. The connector uses v3 by default.
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.3.69 | 2026-10-27 | 89971 | Update dependencies |
| 0.3.68 | 2026-10-20 | 89294 | Update dependencies |
| 0.3.67 | 2026-10-13 | 88685 | Update dependencies |
| 0.3.66 | 2026-10-06 | 87936 | Update dependencies |
| 0.3.65 | 2026-09-29 | 87238 | Update dependencies |
| 0.3.64 | 2026-09-22 | 86714 | Update dependencies |
| 0.3.63 | 2026-09-15 | 86119 | Update dependencies |
| 0.3.62 | 2026-09-08 | 85558 | Update dependencies |
| 0.3.61 | 2026-08-18 | 84674 | Update dependencies |
| 0.3.60 | 2026-08-11 | 84014 | Update dependencies |
| 0.3.59 | 2026-08-04 | 83522 | Update dependencies |
| 0.3.58 | 2026-07-28 | 82991 | Update dependencies |
| 0.3.57 | 2026-07-21 | 82507 | Update dependencies |
| 0.3.56 | 2026-07-14 | 81909 | Update dependencies |
| 0.3.55 | 2026-06-30 | 81150 | Update dependencies |
| 0.3.54 | 2026-06-23 | 80534 | Update dependencies |
| 0.3.53 | 2026-06-16 | 79944 | Update dependencies |
| 0.3.52 | 2026-06-09 | 79403 | Update dependencies |
| 0.3.51 | 2026-06-02 | 78820 | Update dependencies |
| 0.3.50 | 2026-04-28 | 77312 | Update dependencies |
| 0.3.49 | 2026-04-21 | 75838 | Update dependencies |
| 0.3.48 | 2026-03-24 | 74584 | Update dependencies |
| 0.3.47 | 2026-03-03 | 74152 | Update dependencies |
| 0.3.46 | 2026-02-17 | 73223 | Update dependencies |
| 0.3.45 | 2026-02-03 | 72691 | Update dependencies |
| 0.3.44 | 2026-01-20 | 72021 | Update dependencies |
| 0.3.43 | 2026-01-14 | 71469 | Update dependencies |
| 0.3.42 | 2025-12-18 | 70745 | Update dependencies |
| 0.3.41 | 2025-11-25 | 70116 | Update dependencies |
| 0.3.40 | 2025-11-18 | 69581 | Update dependencies |
| 0.3.39 | 2025-10-29 | 68972 | Update dependencies |
| 0.3.38 | 2025-10-21 | 68294 | Update dependencies |
| 0.3.37 | 2025-10-14 | 68046 | Update dependencies |
| 0.3.36 | 2025-10-07 | 67518 | Update dependencies |
| 0.3.35 | 2025-09-30 | 66817 | Update dependencies |
| 0.3.34 | 2025-09-24 | 66646 | Update dependencies |
| 0.3.33 | 2025-09-09 | 66043 | Update dependencies |
| 0.3.32 | 2025-08-23 | 65321 | Update dependencies |
| 0.3.31 | 2025-08-09 | 64607 | Update dependencies |
| 0.3.30 | 2025-08-02 | 64265 | Update dependencies |
| 0.3.29 | 2025-07-26 | 63915 | Update dependencies |
| 0.3.28 | 2025-07-19 | 63508 | Update dependencies |
| 0.3.27 | 2025-07-12 | 63109 | Update dependencies |
| 0.3.26 | 2025-07-05 | 62570 | Update dependencies |
| 0.3.25 | 2025-06-28 | 62198 | Update dependencies |
| 0.3.24 | 2025-06-21 | 61848 | Update dependencies |
| 0.3.23 | 2025-06-14 | 60725 | Update dependencies |
| 0.3.22 | 2025-05-10 | 59896 | Update dependencies |
| 0.3.21 | 2025-05-03 | 59251 | Update dependencies |
| 0.3.20 | 2025-04-26 | 58768 | Update dependencies |
| 0.3.19 | 2025-04-19 | 58183 | Update dependencies |
| 0.3.18 | 2025-04-12 | 57752 | Update dependencies |
| 0.3.17 | 2025-04-05 | 57029 | Update dependencies |
| 0.3.16 | 2025-03-29 | 56670 | Update dependencies |
| 0.3.15 | 2025-03-22 | 56078 | Update dependencies |
| 0.3.14 | 2025-03-08 | 55465 | Update dependencies |
| 0.3.13 | 2025-03-01 | 54810 | Update dependencies |
| 0.3.12 | 2025-02-22 | 54297 | Update dependencies |
| 0.3.11 | 2025-02-15 | 53823 | Update dependencies |
| 0.3.10 | 2025-02-08 | 53258 | Update dependencies |
| 0.3.9 | 2025-02-01 | 52786 | Update dependencies |
| 0.3.8 | 2025-01-25 | 52284 | Update dependencies |
| 0.3.7 | 2025-01-18 | 51815 | Update dependencies |
| 0.3.6 | 2025-01-11 | 51144 | Update dependencies |
| 0.3.5 | 2024-12-28 | 50592 | Update dependencies |
| 0.3.4 | 2024-12-21 | 50128 | Update dependencies |
| 0.3.3 | 2024-12-14 | 49613 | Update dependencies |
| 0.3.2 | 2024-12-12 | 47680 | Update dependencies |
| 0.3.1 | 2024-08-16 | 44196 | Bump source-declarative-manifest version |
| 0.3.0 | 2024-08-15 | 44130 | Refactor connector to manifest-only format |
| 0.2.18 | 2024-08-12 | 43923 | Update dependencies |
| 0.2.17 | 2024-08-10 | 43501 | Update dependencies |
| 0.2.16 | 2024-08-03 | 43098 | Update dependencies |
| 0.2.15 | 2024-07-27 | 42716 | Update dependencies |
| 0.2.14 | 2024-07-20 | 42241 | Update dependencies |
| 0.2.13 | 2024-07-13 | 41890 | Update dependencies |
| 0.2.12 | 2024-07-10 | 41582 | Update dependencies |
| 0.2.11 | 2024-07-06 | 40790 | Update dependencies |
| 0.2.10 | 2024-06-25 | 40491 | Update dependencies |
| 0.2.9 | 2024-06-22 | 40106 | Update dependencies |
| 0.2.8 | 2024-06-06 | 39229 | [autopull] Upgrade base image to v1.2.2 |
| 0.2.7 | 2024-05-28 | 38176 | Make connector compatible with Builder |
| 0.2.6 | 2024-05-02 | 37594 | Change last_recrods to last_record |
| 0.2.5 | 2024-04-19 | 37193 | Updating to 0.80.0 CDK |
| 0.2.4 | 2024-04-18 | 37193 | Manage dependencies with Poetry. |
| 0.2.3 | 2024-04-15 | 37193 | Base image migration: remove Dockerfile and use the python-connector-base image |
| 0.2.2 | 2024-04-12 | 37193 | schema descriptions |
| 0.2.1 | 2023-10-16 | 31405 | Fixed test connection failure if date field is empty |
| 0.2.0 | 2023-08-05 | 29122 | Migrate to Low Code |
| 0.1.1 | 2023-02-13 | 22939 | Specified date formatting in specification |
| 0.1.0 | 2021-11-09 | 8056 | New Source: Mailgun |