# Mautic

> Add and update Mautic contacts from sign-ups and forms, tag and score them, put them in segments and campaigns, send them emails and unsubscribe them. Start a workflow for a new contact, a form submission or a contact added to a segment.

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/mautic

## Actions

### Add or subtract points

Add points to a contact's score, or subtract them, such as 10 for attending a webinar.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Points (`points`, number, required): How many points to add. Use a minus number, such as -5, to subtract.
- Reason (`reason`, text): Why, as shown in the contact's history, such as Attended webinar.

**Outputs**

- `change` (number): The points added; negative when subtracted
- `company` (text): Its primary company
- `date_added` (text): When it was added (ISO 8601)
- `date_identified` (text): When Mautic first knew who it is (ISO 8601)
- `do_not_contact` (list): The channels it mustn't be contacted on: email, sms
- `email` (text): Its email address
- `fields` (object): Every contact field's value, by the field's alias, such as city
- `first_name` (text): First name
- `id` (number): The contact's ID
- `last_active` (text): When it was last active (ISO 8601)
- `last_name` (text): Last name
- `link` (text): A link to it in Mautic
- `mobile` (text): Mobile number
- `owner` (text): The Mautic user who owns it
- `phone` (text): Phone number
- `points` (number): Its points
- `stage` (text): The stage it's in; blank for none
- `tags` (list): Its tags
- `unsubscribed` (true/false): True when it mustn't be sent email (Do Not Contact)

**Example output**

```json
{
  "change": 10,
  "company": "Analytical Engines",
  "date_added": "2026-10-20T09:00:00+00:00",
  "date_identified": "2026-10-20T09:00:00+00:00",
  "do_not_contact": [],
  "email": "ada@example.com",
  "fields": {
    "city": "London",
    "company": "Analytical Engines",
    "email": "ada@example.com",
    "firstname": "Ada",
    "lastname": "Lovelace",
    "points": 15
  },
  "first_name": "Ada",
  "id": 42,
  "last_active": "2026-10-28T11:02:00+00:00",
  "last_name": "Lovelace",
  "link": "https://mautic.example.com/s/contacts/view/42",
  "mobile": "",
  "owner": "Sam Marketer",
  "phone": "+44 20 7946 0000",
  "points": 15,
  "stage": "Lead",
  "tags": [
    "newsletter",
    "webinar"
  ],
  "unsubscribed": false
}
```

### Add tags

Add tags to a contact, keeping the ones it has.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Tags (`tags`, list, required): Tags, such as newsletter or VIP.

**Outputs**

- `company` (text): Its primary company
- `date_added` (text): When it was added (ISO 8601)
- `date_identified` (text): When Mautic first knew who it is (ISO 8601)
- `do_not_contact` (list): The channels it mustn't be contacted on: email, sms
- `email` (text): Its email address
- `fields` (object): Every contact field's value, by the field's alias, such as city
- `first_name` (text): First name
- `id` (number): The contact's ID
- `last_active` (text): When it was last active (ISO 8601)
- `last_name` (text): Last name
- `link` (text): A link to it in Mautic
- `mobile` (text): Mobile number
- `owner` (text): The Mautic user who owns it
- `phone` (text): Phone number
- `points` (number): Its points
- `stage` (text): The stage it's in; blank for none
- `tags` (list): Its tags
- `unsubscribed` (true/false): True when it mustn't be sent email (Do Not Contact)

**Example output**

```json
{
  "company": "Analytical Engines",
  "date_added": "2026-10-20T09:00:00+00:00",
  "date_identified": "2026-10-20T09:00:00+00:00",
  "do_not_contact": [],
  "email": "ada@example.com",
  "fields": {
    "city": "London",
    "company": "Analytical Engines",
    "email": "ada@example.com",
    "firstname": "Ada",
    "lastname": "Lovelace",
    "points": 15
  },
  "first_name": "Ada",
  "id": 42,
  "last_active": "2026-10-28T11:02:00+00:00",
  "last_name": "Lovelace",
  "link": "https://mautic.example.com/s/contacts/view/42",
  "mobile": "",
  "owner": "Sam Marketer",
  "phone": "+44 20 7946 0000",
  "points": 15,
  "stage": "Lead",
  "tags": [
    "newsletter",
    "webinar"
  ],
  "unsubscribed": false
}
```

### Add to campaign

Add a contact to a campaign, which starts the campaign's steps for it when Mautic next runs them.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Campaign (`campaign`, text, required): The campaign. Pick one, or type its name or ID.

**Outputs**

- `added` (true/false): True once it's added
- `campaign_id` (number): The campaign's ID
- `campaign_name` (text): The campaign's name
- `contact_id` (number): The contact's ID

**Example output**

```json
{
  "added": true,
  "campaign_id": 3,
  "campaign_name": "Welcome series",
  "contact_id": 42
}
```

### Add to segment

Add a contact to a segment, such as a newsletter list.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Segment (`segment`, text, required): The segment. Pick one, or type its name or ID.

**Outputs**

- `added` (true/false): True once it's added
- `contact_id` (number): The contact's ID
- `segment_id` (number): The segment's ID
- `segment_name` (text): The segment's name

**Example output**

```json
{
  "added": true,
  "contact_id": 42,
  "segment_id": 3,
  "segment_name": "Newsletter"
}
```

### Change stage

Move a contact to a stage of its lifecycle, such as Lead or Customer.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Stage (`stage`, text, required): The stage. Pick one, or type its name or ID.

**Outputs**

- `company` (text): Its primary company
- `date_added` (text): When it was added (ISO 8601)
- `date_identified` (text): When Mautic first knew who it is (ISO 8601)
- `do_not_contact` (list): The channels it mustn't be contacted on: email, sms
- `email` (text): Its email address
- `fields` (object): Every contact field's value, by the field's alias, such as city
- `first_name` (text): First name
- `id` (number): The contact's ID
- `last_active` (text): When it was last active (ISO 8601)
- `last_name` (text): Last name
- `link` (text): A link to it in Mautic
- `mobile` (text): Mobile number
- `owner` (text): The Mautic user who owns it
- `phone` (text): Phone number
- `points` (number): Its points
- `stage` (text): The stage it's in; blank for none
- `tags` (list): Its tags
- `unsubscribed` (true/false): True when it mustn't be sent email (Do Not Contact)

**Example output**

```json
{
  "company": "Analytical Engines",
  "date_added": "2026-10-20T09:00:00+00:00",
  "date_identified": "2026-10-20T09:00:00+00:00",
  "do_not_contact": [],
  "email": "ada@example.com",
  "fields": {
    "city": "London",
    "company": "Analytical Engines",
    "email": "ada@example.com",
    "firstname": "Ada",
    "lastname": "Lovelace",
    "points": 15
  },
  "first_name": "Ada",
  "id": 42,
  "last_active": "2026-10-28T11:02:00+00:00",
  "last_name": "Lovelace",
  "link": "https://mautic.example.com/s/contacts/view/42",
  "mobile": "",
  "owner": "Sam Marketer",
  "phone": "+44 20 7946 0000",
  "points": 15,
  "stage": "Lead",
  "tags": [
    "newsletter",
    "webinar"
  ],
  "unsubscribed": false
}
```

### Create or update contact

Add a contact, such as someone who signed up, or update the one with the same email. Tags given are added to the ones it has.

**Inputs**

- Email (`email`, text, required): The contact's email address. A contact with this address is updated rather than added again.
- First name (`first_name`, text): The contact's first name.
- Last name (`last_name`, text): The contact's last name.
- Company (`company`, text): The company they work for.
- Phone (`phone`, text): Their phone number.
- Tags (`tags`, list): Tags to add, such as newsletter or webinar.
- Other fields (`fields`, object): Values for any other contact fields, such as City or your own fields. Fill in only what should change.

**Outputs**

- `company` (text): Its primary company
- `created` (true/false): True when the contact is new, false when it was updated
- `date_added` (text): When it was added (ISO 8601)
- `date_identified` (text): When Mautic first knew who it is (ISO 8601)
- `do_not_contact` (list): The channels it mustn't be contacted on: email, sms
- `email` (text): Its email address
- `fields` (object): Every contact field's value, by the field's alias, such as city
- `first_name` (text): First name
- `id` (number): The contact's ID
- `last_active` (text): When it was last active (ISO 8601)
- `last_name` (text): Last name
- `link` (text): A link to it in Mautic
- `mobile` (text): Mobile number
- `owner` (text): The Mautic user who owns it
- `phone` (text): Phone number
- `points` (number): Its points
- `stage` (text): The stage it's in; blank for none
- `tags` (list): Its tags
- `unsubscribed` (true/false): True when it mustn't be sent email (Do Not Contact)

**Example output**

```json
{
  "company": "Analytical Engines",
  "created": true,
  "date_added": "2026-10-20T09:00:00+00:00",
  "date_identified": "2026-10-20T09:00:00+00:00",
  "do_not_contact": [],
  "email": "ada@example.com",
  "fields": {
    "city": "London",
    "company": "Analytical Engines",
    "email": "ada@example.com",
    "firstname": "Ada",
    "lastname": "Lovelace",
    "points": 15
  },
  "first_name": "Ada",
  "id": 42,
  "last_active": "2026-10-28T11:02:00+00:00",
  "last_name": "Lovelace",
  "link": "https://mautic.example.com/s/contacts/view/42",
  "mobile": "",
  "owner": "Sam Marketer",
  "phone": "+44 20 7946 0000",
  "points": 15,
  "stage": "Lead",
  "tags": [
    "newsletter",
    "webinar"
  ],
  "unsubscribed": false
}
```

### Delete contact

Delete a contact and its history from Mautic for good.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.

**Outputs**

- `deleted` (true/false): True once it's deleted
- `email` (text): Its email address
- `id` (number): The contact's ID
- `name` (text): Its name

**Example output**

```json
{
  "deleted": true,
  "email": "ada@example.com",
  "id": 42,
  "name": "Ada Lovelace"
}
```

### Find contacts

Find contacts by name, email or company, in a segment or with a tag, newest first.

**Inputs**

- Search (`query`, text): Words in the contact's name, email or company, or a Mautic search such as email:ada@example.com. Leave blank for everyone.
- Segment (`segment`, text): Only contacts in this segment.
- Tag (`tag`, text): Only contacts with this tag.
- How many (`limit`, number): The most to return, up to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `contacts` (list): The contacts found, newest first
- `count` (number): How many are returned
- `total` (number): How many match in all

**Example output**

```json
{
  "contacts": [
    {
      "company": "Analytical Engines",
      "date_added": "2026-10-20T09:00:00+00:00",
      "date_identified": "2026-10-20T09:00:00+00:00",
      "do_not_contact": [],
      "email": "ada@example.com",
      "fields": {
        "city": "London",
        "company": "Analytical Engines",
        "email": "ada@example.com",
        "firstname": "Ada",
        "lastname": "Lovelace",
        "points": 15
      },
      "first_name": "Ada",
      "id": 42,
      "last_active": "2026-10-28T11:02:00+00:00",
      "last_name": "Lovelace",
      "link": "https://mautic.example.com/s/contacts/view/42",
      "mobile": "",
      "owner": "Sam Marketer",
      "phone": "+44 20 7946 0000",
      "points": 15,
      "stage": "Lead",
      "tags": [
        "newsletter",
        "webinar"
      ],
      "unsubscribed": false
    }
  ],
  "count": 1,
  "total": 1
}
```

### Get contact

Get a contact's details, fields, tags, points, segments and campaigns.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.

**Outputs**

- `campaigns` (list): The campaigns it's in
- `company` (text): Its primary company
- `date_added` (text): When it was added (ISO 8601)
- `date_identified` (text): When Mautic first knew who it is (ISO 8601)
- `do_not_contact` (list): The channels it mustn't be contacted on: email, sms
- `email` (text): Its email address
- `fields` (object): Every contact field's value, by the field's alias, such as city
- `first_name` (text): First name
- `id` (number): The contact's ID
- `last_active` (text): When it was last active (ISO 8601)
- `last_name` (text): Last name
- `link` (text): A link to it in Mautic
- `mobile` (text): Mobile number
- `owner` (text): The Mautic user who owns it
- `phone` (text): Phone number
- `points` (number): Its points
- `segments` (list): The segments it's in
- `stage` (text): The stage it's in; blank for none
- `tags` (list): Its tags
- `unsubscribed` (true/false): True when it mustn't be sent email (Do Not Contact)

**Example output**

```json
{
  "campaigns": [
    {
      "id": 2,
      "name": "Welcome series"
    }
  ],
  "company": "Analytical Engines",
  "date_added": "2026-10-20T09:00:00+00:00",
  "date_identified": "2026-10-20T09:00:00+00:00",
  "do_not_contact": [],
  "email": "ada@example.com",
  "fields": {
    "city": "London",
    "company": "Analytical Engines",
    "email": "ada@example.com",
    "firstname": "Ada",
    "lastname": "Lovelace",
    "points": 15
  },
  "first_name": "Ada",
  "id": 42,
  "last_active": "2026-10-28T11:02:00+00:00",
  "last_name": "Lovelace",
  "link": "https://mautic.example.com/s/contacts/view/42",
  "mobile": "",
  "owner": "Sam Marketer",
  "phone": "+44 20 7946 0000",
  "points": 15,
  "segments": [
    {
      "id": 3,
      "name": "Newsletter"
    }
  ],
  "stage": "Lead",
  "tags": [
    "newsletter",
    "webinar"
  ],
  "unsubscribed": false
}
```

### Remove from campaign

Take a contact out of a campaign, stopping its steps for the contact.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Campaign (`campaign`, text, required): The campaign. Pick one, or type its name or ID.

**Outputs**

- `campaign_id` (number): The campaign's ID
- `campaign_name` (text): The campaign's name
- `contact_id` (number): The contact's ID
- `removed` (true/false): True once it's removed

**Example output**

```json
{
  "campaign_id": 3,
  "campaign_name": "Welcome series",
  "contact_id": 42,
  "removed": true
}
```

### Remove from segment

Take a contact out of a segment. Mautic keeps it out even if the segment's filters match it.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Segment (`segment`, text, required): The segment. Pick one, or type its name or ID.

**Outputs**

- `contact_id` (number): The contact's ID
- `removed` (true/false): True once it's removed
- `segment_id` (number): The segment's ID
- `segment_name` (text): The segment's name

**Example output**

```json
{
  "contact_id": 42,
  "removed": true,
  "segment_id": 3,
  "segment_name": "Newsletter"
}
```

### Remove tags

Take tags off a contact.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Tags (`tags`, list, required): Tags, such as newsletter or VIP.

**Outputs**

- `company` (text): Its primary company
- `date_added` (text): When it was added (ISO 8601)
- `date_identified` (text): When Mautic first knew who it is (ISO 8601)
- `do_not_contact` (list): The channels it mustn't be contacted on: email, sms
- `email` (text): Its email address
- `fields` (object): Every contact field's value, by the field's alias, such as city
- `first_name` (text): First name
- `id` (number): The contact's ID
- `last_active` (text): When it was last active (ISO 8601)
- `last_name` (text): Last name
- `link` (text): A link to it in Mautic
- `mobile` (text): Mobile number
- `owner` (text): The Mautic user who owns it
- `phone` (text): Phone number
- `points` (number): Its points
- `stage` (text): The stage it's in; blank for none
- `tags` (list): Its tags
- `unsubscribed` (true/false): True when it mustn't be sent email (Do Not Contact)

**Example output**

```json
{
  "company": "Analytical Engines",
  "date_added": "2026-10-20T09:00:00+00:00",
  "date_identified": "2026-10-20T09:00:00+00:00",
  "do_not_contact": [],
  "email": "ada@example.com",
  "fields": {
    "city": "London",
    "company": "Analytical Engines",
    "email": "ada@example.com",
    "firstname": "Ada",
    "lastname": "Lovelace",
    "points": 15
  },
  "first_name": "Ada",
  "id": 42,
  "last_active": "2026-10-28T11:02:00+00:00",
  "last_name": "Lovelace",
  "link": "https://mautic.example.com/s/contacts/view/42",
  "mobile": "",
  "owner": "Sam Marketer",
  "phone": "+44 20 7946 0000",
  "points": 15,
  "stage": "Lead",
  "tags": [
    "newsletter",
    "webinar"
  ],
  "unsubscribed": false
}
```

### Resubscribe contact

Let Mautic email a contact again, taking off its Do Not Contact.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Channel (`channel`, text): What the contact is resubscribed to. Defaults to email. One of: `email`, `sms` (Text message). Default: `email`.

**Outputs**

- `company` (text): Its primary company
- `date_added` (text): When it was added (ISO 8601)
- `date_identified` (text): When Mautic first knew who it is (ISO 8601)
- `do_not_contact` (list): The channels it mustn't be contacted on: email, sms
- `email` (text): Its email address
- `fields` (object): Every contact field's value, by the field's alias, such as city
- `first_name` (text): First name
- `id` (number): The contact's ID
- `last_active` (text): When it was last active (ISO 8601)
- `last_name` (text): Last name
- `link` (text): A link to it in Mautic
- `mobile` (text): Mobile number
- `owner` (text): The Mautic user who owns it
- `phone` (text): Phone number
- `points` (number): Its points
- `stage` (text): The stage it's in; blank for none
- `tags` (list): Its tags
- `unsubscribed` (true/false): True when it mustn't be sent email (Do Not Contact)

**Example output**

```json
{
  "company": "Analytical Engines",
  "date_added": "2026-10-20T09:00:00+00:00",
  "date_identified": "2026-10-20T09:00:00+00:00",
  "do_not_contact": [],
  "email": "ada@example.com",
  "fields": {
    "city": "London",
    "company": "Analytical Engines",
    "email": "ada@example.com",
    "firstname": "Ada",
    "lastname": "Lovelace",
    "points": 15
  },
  "first_name": "Ada",
  "id": 42,
  "last_active": "2026-10-28T11:02:00+00:00",
  "last_name": "Lovelace",
  "link": "https://mautic.example.com/s/contacts/view/42",
  "mobile": "",
  "owner": "Sam Marketer",
  "phone": "+44 20 7946 0000",
  "points": 15,
  "stage": "Lead",
  "tags": [
    "newsletter",
    "webinar"
  ],
  "unsubscribed": false
}
```

### Send email

Send one of Mautic's emails to a contact, such as a welcome email, with the contact's own details filled in.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Email (`email`, text, required): The email to send, best a template email. Pick one, or type its name or ID.

**Outputs**

- `contact_id` (number): The contact's ID
- `email_id` (number): The email's ID
- `email_name` (text): The email's name
- `sent` (true/false): True once Mautic has sent it
- `subject` (text): Its subject

**Example output**

```json
{
  "contact_id": 42,
  "email_id": 5,
  "email_name": "Welcome",
  "sent": true,
  "subject": "Welcome to Acme, {contactfield=firstname}"
}
```

### Unsubscribe contact

Stop Mautic emailing a contact (Do Not Contact), such as when they ask by phone. Their history stays.

**Inputs**

- Contact (`contact`, text, required): The contact's ID or email address.
- Channel (`channel`, text): What the contact is unsubscribed from. Defaults to email. One of: `email`, `sms` (Text message). Default: `email`.
- Comments (`comments`, text): Why, as shown on the contact in Mautic, such as Asked by phone.

**Outputs**

- `company` (text): Its primary company
- `date_added` (text): When it was added (ISO 8601)
- `date_identified` (text): When Mautic first knew who it is (ISO 8601)
- `do_not_contact` (list): The channels it mustn't be contacted on: email, sms
- `email` (text): Its email address
- `fields` (object): Every contact field's value, by the field's alias, such as city
- `first_name` (text): First name
- `id` (number): The contact's ID
- `last_active` (text): When it was last active (ISO 8601)
- `last_name` (text): Last name
- `link` (text): A link to it in Mautic
- `mobile` (text): Mobile number
- `owner` (text): The Mautic user who owns it
- `phone` (text): Phone number
- `points` (number): Its points
- `stage` (text): The stage it's in; blank for none
- `tags` (list): Its tags
- `unsubscribed` (true/false): True when it mustn't be sent email (Do Not Contact)

**Example output**

```json
{
  "company": "Analytical Engines",
  "date_added": "2026-10-20T09:00:00+00:00",
  "date_identified": "2026-10-20T09:00:00+00:00",
  "do_not_contact": [
    "email"
  ],
  "email": "ada@example.com",
  "fields": {
    "city": "London",
    "company": "Analytical Engines",
    "email": "ada@example.com",
    "firstname": "Ada",
    "lastname": "Lovelace",
    "points": 15
  },
  "first_name": "Ada",
  "id": 42,
  "last_active": "2026-10-28T11:02:00+00:00",
  "last_name": "Lovelace",
  "link": "https://mautic.example.com/s/contacts/view/42",
  "mobile": "",
  "owner": "Sam Marketer",
  "phone": "+44 20 7946 0000",
  "points": 15,
  "stage": "Lead",
  "tags": [
    "newsletter",
    "webinar"
  ],
  "unsubscribed": true
}
```
