PHPackages                             thedmsgroup/mautic-contact-source-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. thedmsgroup/mautic-contact-source-bundle

ActiveMautic-plugin[API Development](/categories/api)

thedmsgroup/mautic-contact-source-bundle
========================================

Creates API endpoints for receiving contacts from external sources.

2.15.1(6y ago)602.9k16[2 issues](https://github.com/TheDMSGroup/mautic-contact-source/issues)[12 PRs](https://github.com/TheDMSGroup/mautic-contact-source/pulls)GPL-3.0-onlyJavaScript

Since Feb 14Pushed 1y ago25 watchersCompare

[ Source](https://github.com/TheDMSGroup/mautic-contact-source)[ Packagist](https://packagist.org/packages/thedmsgroup/mautic-contact-source-bundle)[ RSS](/packages/thedmsgroup-mautic-contact-source-bundle/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (1)Versions (123)Used By (0)

Mautic Contact Source [![Latest Stable Version](https://camo.githubusercontent.com/676da018355f8344a1a350857e8f3407089cf0d378911b774c9ac7fe69a548c5/68747470733a2f2f706f7365722e707567782e6f72672f746865646d7367726f75702f6d61757469632d636f6e746163742d736f757263652d62756e646c652f762f737461626c65)](https://packagist.org/packages/thedmsgroup/mautic-contact-source-bundle) [![License](https://camo.githubusercontent.com/2f8bad2efa674a3dc5d9c8f33cdaa4d7450a07774d42d2310d4bf5a112c1e363/68747470733a2f2f706f7365722e707567782e6f72672f746865646d7367726f75702f6d61757469632d636f6e746163742d736f757263652d62756e646c652f6c6963656e7365)](https://packagist.org/packages/thedmsgroup/mautic-contact-source-bundle) [![Build Status](https://camo.githubusercontent.com/a6ef7fd20ef7a3225d80f27accfc259bf0e15128ce383475c40cec2a04f0506c/68747470733a2f2f7472617669732d63692e636f6d2f546865444d5347726f75702f6d61757469632d636f6e746163742d736f757263652e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/TheDMSGroup/mautic-contact-source)
============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#mautic-contact-source---)

[![](./Assets/img/source.png)](./Assets/img/source.png)

Creates easy-to-use API endpoints for receiving contacts from external sources.

Designed for use by performance marketers who enhance/exchange contacts in mass quantities. Can optionally be used in tandem with it's sibling [Mautic Contact Client](https://github.com/TheDMSGroup/mautic-contact-client)to discern real-time acceptance criteria with external clients.

Installation &amp; Usage
------------------------

[](#installation--usage)

Choose a release that matches your version of Mautic.

Mautic versionInstallation2.12.x`composer require thedmsgroup/mautic-contact-source-bundle "^2.12"`2.14.x`composer require thedmsgroup/mautic-contact-source-bundle "^2.14"`2.15.x`composer require thedmsgroup/mautic-contact-source-bundle "^2.15"`1. Install by running the command above or by downloading the appropriate version and unpacking the contents into a folder named `/plugins/MauticContactSourceBundle`
2. Go to `/s/plugins/reload`
3. After a refresh you will find "Sources" in the main menu, you can dive in and create your first one.

Endpoints
---------

[](#endpoints)

By default your third parties can POST contacts to urls matching this pattern:

`/source/{sourceId}/campaign/{campaignId}/contact`

Uses these fine libraries:
--------------------------

[](#uses-these-fine-libraries)

- [Bootstrap Slider](https://github.com/seiyria/bootstrap-slider)
- [JSON Editor](https://github.com/json-editor/json-editor)
- [Slate](https://github.com/lord/slate)

Features
--------

[](#features)

- Campaigns: A whitelist of campaigns can be selected for the third party to post into.
- Campaign Caps: Limit the number of contacts accepted to a campaign within defined time frames.
- Campaign Finance: Track the cost/revenue of contacts upon ingestion per campaign.
- Campaign Scrub: Support an optional scrub-rate per campaign which affects the cost/revenue.
- Caps: Rules to limit the quantity of successful contacts can be received.
- Logging: Log statistics on contact ingestion, provide charts when viewing a source in the UI.
- Self-Documentation: Each source (API) generates a public documentation page for a third party (optional).
- Imports: Allows you to assign an import to a Source and Campaign destination.

Todo
----

[](#todo)

- Campaign Required Fields: The fields being used within a campaign should percolate upward to the Source, updating required fields.
- Notifications: Third parties should be notified when their API changes (such as an added campaign or required field change).
- Batch Support: Import multiple contacts at once for improved performance.

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance26

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~8 days

Recently: every ~104 days

Total

69

Last Release

2442d ago

Major Versions

0.38 → 2.12.22018-04-18

### Community

Maintainers

![](https://www.gravatar.com/avatar/b15544847e51ae947aff8bfac6c178fd1337913b3ab871412c0f58733ae1df89?d=identicon)[heathdutton](/maintainers/heathdutton)

---

Top Contributors

[![scottshipman](https://avatars.githubusercontent.com/u/3016737?v=4)](https://github.com/scottshipman "scottshipman (181 commits)")[![heathdutton](https://avatars.githubusercontent.com/u/302215?v=4)](https://github.com/heathdutton "heathdutton (144 commits)")[![dean-martin](https://avatars.githubusercontent.com/u/70493317?v=4)](https://github.com/dean-martin "dean-martin (63 commits)")[![cykonetic](https://avatars.githubusercontent.com/u/1146442?v=4)](https://github.com/cykonetic "cykonetic (27 commits)")[![westonwatson](https://avatars.githubusercontent.com/u/550904?v=4)](https://github.com/westonwatson "westonwatson (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

marketing-automationmauticphppluginpluginMauticmarketingMarketing Automation

### Embed Badge

![Health badge](/badges/thedmsgroup-mautic-contact-source-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/thedmsgroup-mautic-contact-source-bundle/health.svg)](https://phpackages.com/packages/thedmsgroup-mautic-contact-source-bundle)
```

###  Alternatives

[thedmsgroup/mautic-api-services-bundle

Extends Mautic API for configurable service calls.

141.6k](/packages/thedmsgroup-mautic-api-services-bundle)[thedmsgroup/mautic-contact-client-bundle

Create custom integrations without writing code.

1004.0k](/packages/thedmsgroup-mautic-contact-client-bundle)[activecampaign/api-php

Official PHP wrapper for the ActiveCampaign API.

1172.2M12](/packages/activecampaign-api-php)[thedmsgroup/mautic-enhancer-bundle

Various contact enhancer integrations for Mautic.

342.8k](/packages/thedmsgroup-mautic-enhancer-bundle)[thedmsgroup/mautic-extended-field-bundle

Extends custom fields for scalability and HIPAA/PCI compliance.

293.1k](/packages/thedmsgroup-mautic-extended-field-bundle)[thedmsgroup/mautic-health-bundle

Checks the health of the Mautic instance.

1210.8k](/packages/thedmsgroup-mautic-health-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
