ContextQMD
Back to Airbyte

MailGun

docs/integrations/sources/mailgun.md

2.0.010.2 KB
Original Source

MailGun

This page contains the setup guide and reference information for the MailGun source connector.

Prerequisites

Api key is mandate for this connector to work, It could be seen at Mailgun dashboard at settings, Navigate through API Keys section and click on the eye icon next to Private API key See reference. Just pass the generated API key for establishing the connection.

Setup guide

Step 1: Set up MailGun connection

  • Generate an API key (Example: 12345)
  • Params (If specific info is needed)
  • Available params
    • Domain Region Code: Domain region code. 'EU' or 'US' are possible values. The default is 'US'.
    • Replication Start Date: UTC date and time in the format 2020-10-01 00:00:00. Any data before this date will not be replicated. If omitted, defaults to 90 days ago.

Step 2: Set up the MailGun connector in Airbyte

For Airbyte Cloud:

  1. Log into your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
  3. On the Set up the source page, enter the name for the MailGun connector and select MailGun from the Source type dropdown.
  4. Enter your api_key as private_key.
  5. Enter the optional params configuration if needed. Supported params are: Domain Region Code, Replication Start Date.
  6. Click Set up source.

For Airbyte OSS:

  1. Navigate to the Airbyte Open Source dashboard.
  2. Set the name for your source.
  3. Enter your api_key as pivate_key.
  4. Enter the optional params configuration if needed. Supported params are: Domain Region Code, Replication Start Date.
  5. Click Set up source.

Supported sync modes

The MailGun source connector supports the following sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental SyncYes
Replicate Incremental DeletesNo
SSL connectionYes
NamespacesNo

Supported Streams

  • domains
  • events

API method example

GET https://api.mailgun.net/v3/domains

Performance considerations

MailGun's API reference has v3 at present and v4 is at development. The connector as default uses v3.

Changelog

<details> <summary>Expand to review</summary>
VersionDatePull RequestSubject
0.3.472026-03-0374152Update dependencies
0.3.462026-02-1773223Update dependencies
0.3.452026-02-0372691Update dependencies
0.3.442026-01-2072021Update dependencies
0.3.432026-01-1471469Update dependencies
0.3.422025-12-1870745Update dependencies
0.3.412025-11-2570116Update dependencies
0.3.402025-11-1869581Update dependencies
0.3.392025-10-2968972Update dependencies
0.3.382025-10-2168294Update dependencies
0.3.372025-10-1468046Update dependencies
0.3.362025-10-0767518Update dependencies
0.3.352025-09-3066817Update dependencies
0.3.342025-09-2466646Update dependencies
0.3.332025-09-0966043Update dependencies
0.3.322025-08-2365321Update dependencies
0.3.312025-08-0964607Update dependencies
0.3.302025-08-0264265Update dependencies
0.3.292025-07-2663915Update dependencies
0.3.282025-07-1963508Update dependencies
0.3.272025-07-1263109Update dependencies
0.3.262025-07-0562570Update dependencies
0.3.252025-06-2862198Update dependencies
0.3.242025-06-2161848Update dependencies
0.3.232025-06-1460725Update dependencies
0.3.222025-05-1059896Update dependencies
0.3.212025-05-0359251Update dependencies
0.3.202025-04-2658768Update dependencies
0.3.192025-04-1958183Update dependencies
0.3.182025-04-1257752Update dependencies
0.3.172025-04-0557029Update dependencies
0.3.162025-03-2956670Update dependencies
0.3.152025-03-2256078Update dependencies
0.3.142025-03-0855465Update dependencies
0.3.132025-03-0154810Update dependencies
0.3.122025-02-2254297Update dependencies
0.3.112025-02-1553823Update dependencies
0.3.102025-02-0853258Update dependencies
0.3.92025-02-0152786Update dependencies
0.3.82025-01-2552284Update dependencies
0.3.72025-01-1851815Update dependencies
0.3.62025-01-1151144Update dependencies
0.3.52024-12-2850592Update dependencies
0.3.42024-12-2150128Update dependencies
0.3.32024-12-1449613Update dependencies
0.3.22024-12-1247680Update dependencies
0.3.12024-08-1644196Bump source-declarative-manifest version
0.3.02024-08-1544130Refactor connector to manifest-only format
0.2.182024-08-1243923Update dependencies
0.2.172024-08-1043501Update dependencies
0.2.162024-08-0343098Update dependencies
0.2.152024-07-2742716Update dependencies
0.2.142024-07-2042241Update dependencies
0.2.132024-07-1341890Update dependencies
0.2.122024-07-1041582Update dependencies
0.2.112024-07-0640790Update dependencies
0.2.102024-06-2540491Update dependencies
0.2.92024-06-2240106Update dependencies
0.2.82024-06-0639229[autopull] Upgrade base image to v1.2.2
0.2.72024-05-2838176Make connector compatible with Builder
0.2.62024-05-0237594Change last_recrods to last_record
0.2.52024-04-1937193Updating to 0.80.0 CDK
0.2.42024-04-1837193Manage dependencies with Poetry.
0.2.32024-04-1537193Base image migration: remove Dockerfile and use the python-connector-base image
0.2.22024-04-1237193schema descriptions
0.2.12023-10-1631405Fixed test connection failure if date field is empty
0.2.02023-08-0529122Migrate to Low Code
0.1.12023-02-1322939Specified date formatting in specification
0.1.02021-11-098056New Source: Mailgun
</details>