Mautic is an open-source marketing automation platform. It enables you to segment your contacts based on business requirements, personalize your marketing strategy, and create personalized campaigns for better customer engagement.

RudderStack supports Mautic as a destination where you can seamlessly send your event data.

Getting started

Before configuring Mautic as a destination in RudderStack, verify if the source platform is supported by Mautic by referring to the table below:

Once you have confirmed that the source platform supports sending events to Mautic, follow these steps:

1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select Mautic.
2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure Mautic as a destination, you will need to configure the following settings:

• Username: Enter the username associated with your Mautic account.
• Password: Enter the password for the above username.
• Subdomain Name: Enter the subdomain associated with your Mautic instance. For example, if the root URL for your Mautic instance is customdomain.domain.com, then your subdomain name will be customdomain.
• Mautic property name to used as lookup field: Enter a unique Mautic user property which RudderStack will use for contact lookup.

Identify

You can use the identify call to create or update a user in Mautic.

A sample identify call is shown below:

Copy
rudderanalytics.identify("1hKOmRA4GRlm", {
  state: "Louisiana",
  firstName: "Alex",
  lastName: "Keener",
  title: "Mr",
  zipcode: "90009",
  prospectOrCustomer: "Customer",
  country: "USA",
  website: "www.alex.com",
  subscriptionStatus: "New",
  phone: "12025550146",
});

Supported mappings

The following table lists the mappings between the optional RudderStack and Mautic properties:

Getting contact details

The easiest way to retrieve contact details of an existing user in Mautic is by specifying the unique user trait in the Mautic property name to used as lookup field dashboard setting. RudderStack will look for this property in the event's traits or context.traits and use the value for contact lookup.

If the events do not contain the property specified in the above setting, then:

• RudderStack uses the email property in the event.
• If email is not present, RudderStack then creates a new contact in Mautic.

Optionally, you can also pass the contact ID in your event's externalId, as shown:

Copy
{
  "context": {
    "externalId": [{
      "type": "mauticContactId",
      "id": "1hKOmRA4GRlm"
    }]
  }
}

Group

You can use the group call to link or delink a Mautic contact with a segment, campaign, or a company.

A sample group call is shown below:

Copy
rudderanalytics.group("group01", {
  "name": "Alex Keener",
  "type": "Segments",
  "operation": "add"
});

RudderStack uses the type trait present in the group call to link or delink a Mautic user to a segment, campaign, or company. You can add or remove a user to a group using the operation trait. If this field is not explicitly set, RudderStack sets it to add by default.

The following table lists the supported group traits:

Similar to the identify call above, RudderStack retrieves the contact ID from the group call in the following order of precedence:

1. If externalId is present, RudderStack checks if the type is set to mauticContactId. If yes, it uses the id field for the contact lookup.
2. If you have specified a unique user property in the Mautic property name to used as lookup field dashboard setting, RudderStack will look for this property in the event's traits or context.traits and use it for the contact lookup.
3. If the events do not contain the property specified in the above setting, then:
   • RudderStack uses the email property in the event.
   • If email is not present, RudderStack then gives an error.

Supported mappings

The following table lists the mappings between the RudderStack and Mautic properties:

• Assigning a single contact to a segment

• Assigning a contact to a campaign

• Assigning a contact to a company