PHPackages                             costamateus/laravel-mautic-api - 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. [Mail & Notifications](/categories/mail)
4. /
5. costamateus/laravel-mautic-api

ActiveLibrary[Mail & Notifications](/categories/mail)

costamateus/laravel-mautic-api
==============================

Free and Open Source Marketing Automation API

v3.0.5(7mo ago)66.1k↓25%10MITPHPPHP ^8.2CI passing

Since Nov 27Pushed 7mo ago1 watchersCompare

[ Source](https://github.com/CostaMateus/laravel-mautic-api)[ Packagist](https://packagist.org/packages/costamateus/laravel-mautic-api)[ RSS](/packages/costamateus-laravel-mautic-api/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (5)Versions (19)Used By (0)

Mautic API in Laravel 11.
=========================

[](#mautic-api-in-laravel-11)

Free and Open Source Marketing Automation API

Requirements
------------

[](#requirements)

- cURL support

### v 2.0.7

[](#v-207)

- Laravel ^8.0
- PHP ^7.3 or newer

### v 3.0.1

[](#v-301)

- Laravel ^9.0
- PHP ^8.0.2 or newer

### v 3.0.2

[](#v-302)

- Laravel ^10.0
- PHP ^8.1 or newer

### v 3.0.3

[](#v-303)

- Laravel ^11.0
- PHP ^8.2 or newer

### v 3.0.4

[](#v-304)

- Laravel ^12.0
- PHP ^8.2 or newer

Mautic Setup
------------

[](#mautic-setup)

The API must be enabled in Mautic.

Within Mautic, go to the Configuration page (located in the Settings menu) and under API Settings enable Mautic's API. You can also choose which OAuth2 protocol to use here.

After saving the configuration, go to the API Credentials page (located in the Settings menu) and create a new client. Enter the `callback/redirect` URI ( must be `https://your-app.com/mautic/application/register`) that the request will be sent from. Click Apply then copy the `Client ID` and `Client Secret` to the application that will be using the API.

Installation
------------

[](#installation)

First, you'll need to require the package with Composer:

```
composer require costamateus/laravel-mautic-api
```

Aftwards, run `composer update` from your command line.

Then, update `config/app.php` by adding an entry for the service provider.

```
'providers' => [
	// ...
	Triibo\Mautic\MauticServiceProvider::class,
],
```

Then, register class alias by adding an entry in aliases section

```
'aliases' => [
    // ...
    'Mautic' => Triibo\Mautic\Facades\Mautic::class,
],
```

Finally, from the command line run `php artisan vendor:publish --provider="Triibo\Mautic\MauticServiceProvider"` to publish the default configuration file. This will publish a configuration file name `mautic.php`, `consumer migration` and `consumer model`.

Then, run `php artisan migrate` migration command to create consumer table in your database.

Configuration
-------------

[](#configuration)

You need to add your `client id`, `client secret` and `callback url` for OAuth2 or `username` and `password` for BasicAuth in `config/mautic.php`. Or put it in your `.env` file.

```
## OAuth2
MAUTIC_BASE_URL="https://your-mautic.com"
MAUTIC_PUBLIC_KEY="publicKey"
MAUTIC_SECRET_KEY="secretKey"
MAUTIC_CALLBACK="https://your-app.com/mautic/application/register"
## or BasicAuth
MAUTIC_BASE_URL="https://your-mautic.com"
MAUTIC_USERNAME="username"
MAUTIC_PASSWORD="password"

```

Authorization
-------------

[](#authorization)

This Library only supports `OAuth2` and `BasicAuth` Authentication. For OAuth2 you need to create a `OAuth2` client in order to use the api.

Registering Application
-----------------------

[](#registering-application)

In order to register you application with mautic ping this url this is one time registration.

```
http://your-app.com/mautic/application/register
```

Usage
=====

[](#usage)

Add Mautic Facade in your controller.

```
use Triibo\Mautic\Facades\Mautic;
```

#### Send a request to mautic ( Example )

[](#send-a-request-to-mautic--example-)

Create a new contact in mautic.

```
$params = array(
    'firstname' => 'Prince',
    'lastname'  => 'Ali Khan',
    'email'     => 'princealikhan08@gmail.com'
);

Mautic::request('POST','contacts/new',$params);
```

Get List of all contacts

```
Mautic::request('GET','contacts');
```

Get a unique contact

```
Mautic::request('GET','contacts/1');
//where 1 is unique id for a contact.
```

Delete a contact

```
Mautic::request('Delete','contacts/1/delete');
```

##### And many more endpoints support by mautic.

[](#and-many-more-endpoints-support-by-mautic)

### List of Endpoints supported by Mautic.

[](#list-of-endpoints-supported-by-mautic)

#### Assets

[](#assets)

```
[
    "assets",
    "assets/new",
    "assets/{asset_id}",
    "assets/{asset_id}/edit",
    "assets/{asset_id}/delete"
]
```

#### Campaigns

[](#campaigns)

```
[
    "campaigns",
    "campaigns/new",
    "campaigns/{campaign_id}",
    "campaigns/{campaign_id}/contacts",
    "campaigns/clone/{campaign_id}",
    "campaigns/{campaign_id}/edit",
    "campaigns/{campaign_id}/delete",
    "campaigns/{campaign_id}/contact/{contact_id}/add",
    "campaigns/{campaign_id}/contact/{contact_id}/remove"
]
```

#### Categories

[](#categories)

```
[
    "categories",
    "categories/new",
    "categories/{category_id}",
    "categories/{category_id}/edit",
    "categories/{category_id}/delete"
]
```

#### Companies

[](#companies)

```
[
    "companies",
    "companies/new",
    "companies/{company_id}",
    "companies/{company_id}/edit",
    "companies/{company_id}/delete",
    "companies/{company_id}/contact/{contact_id}/add",
    "companies/{company_id}/contact/{contact_id}/remove"
]
```

#### Contacts

[](#contacts)

```
[
    "contacts",
    "contacts/batch/new",
    "contacts/batch/edit",
    "contacts/batch/delete",
    "contacts/new",
    "contacts/{contact_id}",
    "contacts/{contact_id}/edit",
    "contacts/{contact_id}/delete",
    "contacts/{contact_id}/dnc/{channel}/add",
    "contacts/{contact_id}/dnc/{channel}/remove",
    "contacts/{contact_id}/utm/add",
    "contacts/{contact_id}/utm/{utm_id}/remove",
    "contacts/{contact_id}/points/plus/{points}",
    "contacts/{contact_id}/points/minus/{points}",
    "contacts/list/owners",
    "contacts/list/fields",
    "contacts/{contact_id}/notes",
    "contacts/{contact_id}/segments",
    "contacts/{contact_id}/campaigns"
    "contacts/{contact_id}/events",
    "contacts/{contact_id}/activity",
    "contacts/activity",
    "contacts/{contact_id}/companies",
    "contacts/{contact_id}/devices"
]
```

#### Data

[](#data)

```
[
    "data",
    "data/{type}",
    "data/emails.in.time",
    "data/sent.email.to.contacts",
    "data/most.hit.email.redirects"
]
```

#### Dynamic Content

[](#dynamic-content)

```
[
    "dynamiccontents",
    "dynamiccontents/new",
    "dynamiccontents/{dynamiccontent_id}",
    "dynamiccontents/{dynamiccontent_id}/edit",
    "dynamiccontents/{dynamiccontent_id}/delete"
]
```

#### Emails

[](#emails)

```
[
    "emails",
    "emails/new",
    "emails/{email_id}",
    "emails/{email_id}/edit",
    "emails/{email_id}/delete",
    "emails/{email_id}/send",
    "emails/reply/{tracking_hash}"
]
```

#### Fields

[](#fields)

```
[
    "fields/company",
    "fields/company/new",
    "fields/company/{company_id}",
    "fields/company/{company_id}/edit",
    "fields/company/{company_id}/delete",
    "fields/contact",
    "fields/contact/new",
    "fields/contact/{contact_id}",
    "fields/contact/{contact_id}/edit",
    "fields/contact/{contact_id}/delete"
]
```

#### Files

[](#files)

```
[
    "files/images",
    "files/{dir}/new",
    "files/{dir}/{file}/delete"
]
```

#### Forms

[](#forms)

```
[
    "forms",
    "forms/new",
    "forms/{form_id}",
    "forms/{form_id}/edit",
    "forms/{form_id}/delete",
    "forms/{form_id}/fields/delete",
    "forms/{form_id}/actions/delete",
    "forms/{form_id}/submissions",
    "forms/{form_id}/submissions/contact/{contact_id}",
    "forms/{form_id}/submissions/{submission_id}"
]
```

#### Marketing Messages

[](#marketing-messages)

```
[
    "messages",
    "messages/new",
    "messages/{message_id}",
    "messages/{message_id}/edit",
    "messages/{message_id}/delete"
]
```

#### Notes

[](#notes)

```
[
    "notes",
    "notes/new",
    "notes/{note_id}",
    "notes/{note_id}/edit",
    "notes/{note_id}/delete"
]
```

#### Notifications

[](#notifications)

```
[
    "notifications",
    "notifications/new",
    "notifications/{notification_id}",
    "notifications/{notification_id}/edit",
    "notifications/{notification_id}/delete"
]
```

#### Pages

[](#pages)

```
[
    "pages",
    "pages/new",
    "pages/{page_id}",
    "pages/{page_id}/edit",
    "pages/{page_id}/delete"
]
```

#### Points Actions

[](#points-actions)

```
[
    "points",
    "points/new",
    "points/{point_id}",
    "points/{point_id}/edit",
    "points/{point_id}/delete",
    "points/actions/types",
    "points/triggers",
    "points/triggers/new",
    "points/triggers/{point_id}",
    "points/triggers/{point_id}/edit",
    "points/triggers/{point_id}/delete",
    "points/triggers/{point_id}/events/delete",
    "points/triggers/events/types"
]
```

#### Reports

[](#reports)

```
[
    "reports",
    "reports/{report_id}"
]
```

#### Roles

[](#roles)

```
[
    "roles",
    "roles/new",
    "roles/{role_id}",
    "roles/{role_id}/edit",
    "roles/{role_id}/delete"
]
```

#### Segments

[](#segments)

```
[
    "segments",
    "segments/new",
    "segments/{segment_id}",
    "segments/{segment_id}/edit",
    "segments/{segment_id}/delete",
    "segments/{segment_id}/contact/{contact_id}/add",
    "segments/{segment_id}/contact/{contact_id}/remove"
]
```

#### Text messages

[](#text-messages)

```
[
    "smses",
    "smses/new",
    "smses/{sms_id}",
    "smses/{sms_id}/edit",
    "smses/{sms_id}/delete",
    "smses/{sms_id}/contact/{contact_id}/send"
]
```

#### Stages

[](#stages)

```
[
    "stages",
    "stages/new",
    "stages/{stage_id}",
    "stages/{stage_id}/edit",
    "stages/{stage_id}/delete",
    "stages/{stage_id}/contact/{contact_id}/add",
    "stages/{stage_id}/contact/{contact_id}/remove"
]
```

#### Stats

[](#stats)

```
[
    "stats",
    "stats/{table}"
]
```

#### Tags

[](#tags)

```
[
    "tags",
    "tags/new",
    "tags/{tag_id}",
    "tags/{tag_id}/edit",
    "tags/{tag_id}/delete"
]
```

#### Themes

[](#themes)

```
[
    "themes",
    "themes/new",
    "themes/{theme_name}",
    "themes/{theme_name}/delete"
]
```

#### Tweets

[](#tweets)

```
[
    "tweets",
    "tweets/new",
    "tweets/{tweet_id}",
    "tweets/{tweet_id}/edit",
    "tweets/{tweet_id}/delete"
]
```

#### Users

[](#users)

```
[
    "users",
    "users/new",
    "users/{user_id}",
    "users/{user_id}/edit",
    "users/{user_id}/delete",
    "users/self",
    "users/{user_id}/permissioncheck"
]
```

#### Webhooks

[](#webhooks)

```
[
    "hooks",
    "hooks/new",
    "hooks/{hook_id}",
    "hooks/{hook_id}/edit",
    "hooks/{hook_id}/delete",
    "hooks/triggers"
]
```

Please refer to [Documentation](https://developer.mautic.org). for all customizable parameters.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance64

Regular maintenance activity

Popularity28

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity84

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 65.7% of commits — single point of failure

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 ~190 days

Total

18

Last Release

221d ago

Major Versions

v1.2.2 → v2.0.02021-03-19

v2.0.7 → v3.0.02023-09-22

PHP version history (5 changes)v1.0PHP >=5.5.9

v2.0.0PHP ^7.3|^8.0

v3.0.0PHP ^8.0.2

v3.0.2PHP ^8.1

v3.0.3PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/34cfeaf003368fd9f75d0d147c3940ac6b31321b899840d025ece79bacdb0933?d=identicon)[CostaMateus](/maintainers/CostaMateus)

---

Top Contributors

[![CostaMateus](https://avatars.githubusercontent.com/u/19847297?v=4)](https://github.com/CostaMateus "CostaMateus (46 commits)")[![princealikhan](https://avatars.githubusercontent.com/u/6194551?v=4)](https://github.com/princealikhan "princealikhan (10 commits)")[![inkas](https://avatars.githubusercontent.com/u/10758776?v=4)](https://github.com/inkas "inkas (5 commits)")[![harryspink](https://avatars.githubusercontent.com/u/3799258?v=4)](https://github.com/harryspink "harryspink (3 commits)")[![backstageel](https://avatars.githubusercontent.com/u/1692858?v=4)](https://github.com/backstageel "backstageel (3 commits)")[![hybrid1969](https://avatars.githubusercontent.com/u/6799141?v=4)](https://github.com/hybrid1969 "hybrid1969 (2 commits)")[![joao-pedro-alves](https://avatars.githubusercontent.com/u/6307532?v=4)](https://github.com/joao-pedro-alves "joao-pedro-alves (1 commits)")

---

Tags

apilaravellaravel 10automationemailMauticmarketingsync

### Embed Badge

![Health badge](/badges/costamateus-laravel-mautic-api/health.svg)

```
[![Health](https://phpackages.com/badges/costamateus-laravel-mautic-api/health.svg)](https://phpackages.com/packages/costamateus-laravel-mautic-api)
```

###  Alternatives

[princealikhan/laravel-mautic-api

Free and Open Source Marketing Automation API

415.9k](/packages/princealikhan-laravel-mautic-api)[erag/laravel-disposable-email

A Laravel package to detect and block disposable email addresses.

226102.4k](/packages/erag-laravel-disposable-email)[hafael/azure-mailer-driver

Supercharge your Laravel or Symfony app with Microsoft Azure Communication Services (ACS)! Effortlessly add email, chat, voice, video, and telephony-over-IP for next-level communication. 🚀

14109.2k](/packages/hafael-azure-mailer-driver)

PHPackages © 2026

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