Mautic

The Mautic modules enable you to monitor events, search, retrieve, create, update or delete contacts and companies in your Mautic account.

Getting Started with Mautic

Prerequisites

  • A Mautic account

  • A Mautic domain

In order to use Mautic with Make, it is necessary to have a Mautic account. If you do not have one, you can create a Mautic account at www.mautic.org/user/login.

Note

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!

Connecting Mautic to Make

To connect your Mautic account to Make you need to enable the API in your Mautic account and obtain your Domain, Client ID and Client Secret.

Enabling API

  1. Log in to your Mautic account.

  2. Go to Settings > Configuration.

    61f2732ed0ab1.gif
  3. Open API Settings and switch API enabled? option to Yes and save the dialog by clicking the Apply or Save & Close button.

    61f27331b8276.gif

Retrieving API Credentials

  1. Log in to your Mautic account.

  2. Go to Settings > API Credentials.

    61f2733426f8d.gif
  3. Click the +New button.

    61f27336c7e4b.png
  4. Fill the dialog fields as follows:

    Authorization Protocol

    OAuth 2

    Name

    Enter the desired name, for example: Make

    Redirect URI

    https://www.integromat.com/oauth/cb/mautic

  5. Click the Save & Close button.

  6. Find the Client ID (Public Key) and Client Secret in the API Credentials page.

    61f27337dbc57.png
  7. Go to Make and open the Mautic module's Create a connection dialog.

  8. Enter the Client ID and Client Secret you have retrieved in step 7 to the respective fields and click the Continue button to establish the connection.

  9. After you click the Continue button, Make will redirect you to the Mautic website where you will be prompted to grant Make access to your account.

    61f27339032e0.png

Confirm the dialog by clicking the Accept button.

The connection has been established. You can proceed with setting up the module.

Troubleshooting

Unable to Connect

Try to clean the Mautic cache. To ensure that the Mautic API is operating correctly, you need to perform a cache cleanup after API activation. To do this, execute the following command at the server console:

sudo su daemon -s /bin/bash -c "/opt/bitnami/php/bin/php /opt/bitnami/apps/mautic/htdocs/app/console cache:clear --env=prod"

(Reference: https://docs.bitnami.com/oci/apps/mautic/administration/clean-cache/)

Note

You may need to restart the server after cleaning the Mautic cache.

Event

Triggers when a specified event occurs in your account.

Webhook Name

Enter the name for the webhook. E.g. Form Submitted.

Connection

Establish a connection to your Mautic account.

Event

Select the event that will trigger the Watch Events module.

Webhook Name

Enter the webhook name that will be displayed in the Mautic account in the Settings > Webhooks section.

Description

Enter the description of the webhook.

Contact

Searches for the specified contact.

Connection

Establish a connection to your Mautic account.

Search Contacts

Enter the search term you want to search contacts for.

Limit

Set the maximum number of contacts Make will return during one execution cycle.

Retrieves contact details.

Connection

Establish a connection to your Mautic account.

Contacts ID

Enter (map) or select the contact you want to retrieve details about.

Creates a new contact.

Note

If the existing email is entered, the contact with this email will be updated.

Connection

Establish a connection to your Mautic account.

Owner

Enter or select the ID of a Mautic user to assign this contact to.

Title

Enter the contact's title.

First Name

Enter the first name of the contact.

Last Name

Enter the last name of the contact.

Primary Company

Enter the contact's company.

Position

Enter the contact’s position title.

Email

Enter the valid email of the contact.

Mobile

Enter the mobile phone number.

Phone

Enter the phone number.

Points

Contact’s current number of points.

Fax

Enter the fax number.

Address Line 1

Enter the contact's address.

Address Line 2

Enter the contact's address.

City

Enter the city of the contact.

State

Enter the state of the contact if needed.

ZIP Code

Enter the ZIP Code.

Country

Enter the contact's country.

Preferred Locale

Enter the language locale in the following format:[language designator]_[region designator] e.g.en_US

Date Last Active

Date/time for when the contact was last recorded as active. The list of supported date and time formats.

Attribution Date

Enter the attribution date. The list of supported date and time formats.

Attribution

Set the attribution.

Social Media

Enter desired social media profiles.

Tags

Add tags to the contact.

Updates an existing contact.

Connection

Establish a connection to your Mautic account.

Contact ID

Enter or select the ID of the contact you want to update.

Please find the descriptions of the fields in the Create/Update a Contact section above.

Deletes a contact.

Connection

Establish a connection to your Mautic account.

Contact ID

Enter or select the ID of the contact you want to delete.

Company

Retrieves companies in your Mautic account.

Connection

Establish a connection to your Mautic account.

Limit

Set the maximum number of companies Make will return during one execution cycle.

Retrieves company details.

Connection

Establish a connection to your Mautic account.

Company

Enter or select the company you want to retrieve details about.

Creates a new company.

Note

If the existing company name is entered, the company with this name will be updated.

Connection

Establish a connection to your Mautic account.

Company Name

Enter the name of the company.

Address 1

Enter the company address.

Address 2

Enter the second line of the company address.

Company Email

Enter the email address of the company.

Phone

Enter the company's phone number.

City

Enter the city of the company.

State

Enter the state of the company.

ZIP Code

Enter the company's ZIP code.

Country

Enter the country of the company.

Website

Enter the company's website URL.

Number of Employees

Enter the number of company employees.

Fax

Enter the fax number of the company.

Annual Revenue

Enter the company's annual revenue.

Industry

Select the industry of the company.

Description

Enter the description of the company.

Updates an existing company.

Connection

Establish a connection to your Mautic account.

Company ID

Enter (map) or select the ID of the company you want to update.

Please find the descriptions of the fields in the Create/Update a Company section above.

Deletes a company.

Connection

Establish a connection to your Mautic account.

Company

Enter or select the ID of the company you want to delete.

Make an API Call

Allows you to perform a custom API call.

Connection

Establish a connection to your Mautic account.

URL

Enter a path relative to https://your-domain.com/api. E.g. /contacts

Note

For the list of available endpoints, refer to the Mautic API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Contacts

The following API call returns the first 10 contacts in your Mautic account:

URL:

/contacts

Method:

GET

Query String:

Key:

limit

Value:

10

61f2733a090fb.png

The result can be found in the module's Output under Bundle > Body > contacts. In our example, 10 contacts were returned:

61f2733b0c90f.png