Connect Mautic

Updated Oct 26, 2026 · 4 min read · Pro, Business and Agency plans

This article shows you how to connect your own Mautic to PlayerMagick, add the emails a gate collects to a segment with tags, start and stop Mautic campaigns from what people watch, and recognise your Mautic contacts.

Available on: Pro, Business and Agency plans.

Before you start

  • You need a Mautic installation that is reachable on the internet at an https:// address (port 443), and a Mautic user who can manage API credentials.
  • PlayerMagick only connects to public addresses. Addresses inside a private network (like 192.168.… or localhost) are refused.
  • Only the PlayerMagick account owner or an admin can connect Mautic. See Understand team roles.

Mautic's menus differ a little between versions. If a label below does not match exactly, look for the closest one.

Step 1: Turn on the API and create credentials in Mautic

  1. In Mautic, open Settings (the cog) → Configuration → API Settings.
  2. Set API enabled? to Yes and save.
  3. Open Settings → API Credentials and click New.
  4. Choose OAuth 2, name it PlayerMagick, and save.
  5. Copy the Client ID and the Client Secret.

PlayerMagick uses these credentials directly (OAuth 2 "client credentials"): it never needs a Mautic user's password.

Step 2: Connect Mautic in PlayerMagick

  1. Go to Settings → Integrations.
  2. Click Connect an email tool and choose Mautic.
  3. Type the Address of your installation, for example https://mautic.yourcompany.com. If Mautic lives in a folder, include it: https://yourcompany.com/mautic.
  4. Paste the Client ID and the Client secret.
  5. Click Test and connect.

Step 3: Send a gate's leads to Mautic

  1. Open your video, click the Interactions tab and click the email gate.
  2. Under Send leads to, choose Mautic and a Segment, or tags only.
  3. Add up to 5 Tags if you like.
  4. Click Save destination.
  • Confirmation emails: Mautic has no double opt-in switch for other apps. If you need one, build a campaign that sends your confirmation email to the segment.
  • Use a segment you add people to by hand. A segment with filters may add or drop people on its own the next time Mautic updates it.

Start and stop Mautic campaigns from what people watch

In Automations, add the action Start campaign or Remove from campaign and choose one of your published Mautic campaigns. Mautic runs campaigns on your server's schedule (its cron jobs), so the first email may take a few minutes.

Other actions for Mautic: Add tag, Remove tag, Add to a segment, Remove from a segment and Update a field (a contact field by its alias; date fields take dates like 2026-10-28).

Recognise viewers from your Mautic emails

Mautic numbers its contacts in order, so the number is easy to guess. PlayerMagick uses its own random ID instead:

  1. PlayerMagick creates a contact field called pm_id (label "PlayerMagick ID") and fills it for every contact it adds or updates. If your API credentials may not create fields, create a Text contact field with the alias pm_id yourself.
  2. In Automations → Recognise viewers from your emails, choose Mautic and click Fill it for my existing contacts to give your other contacts an ID too.
  3. Add this to the end of the links in your Mautic emails:

?pm_mt={contactfield=pm_id}

Mautic does not fill tokens in test emails: send a real email to a test segment and use Check a link.

Good to know

  • Someone on Mautic's "do not contact" list (unsubscribed, bounced or added by hand) is never added again. Leads shows Not added.
  • Speed: PlayerMagick sends at most a few requests a second to your server.
  • Safety: PlayerMagick checks the address before every request, never follows a redirect, and never shows what your server answered in an error.

Error messages

MessageWhat to do
"Use the https:// address of your installation (a public address, port 443)."Type the https address your browser uses for Mautic. Plain http, other ports, IP addresses and private addresses are refused.
"Mautic did not accept this key. Check that you copied the whole key."Copy the Client ID and Client Secret again, and check that the credentials are OAuth 2.
"This key can’t read your lists. Use a key of a user who can manage contacts."Turn the API on in Configuration → API Settings, and give the credentials' role access to contacts and segments.
"Mautic didn’t answer. Try again in a minute."Check that your Mautic is online at that address, then try again.

All statuses and fixes: Fix an email tool error.

Was this article helpful?