Connect Flodesk

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

This article shows you how to create a Flodesk API key, connect Flodesk to PlayerMagick, add the emails a gate collects to a Flodesk segment, and start or stop Flodesk workflows from what people watch.

Available on: Pro, Business and Agency plans.

Before you start

  • You need a paid Flodesk plan: Flodesk gives API keys to paying members only.
  • Only the PlayerMagick account owner or an admin can connect Flodesk. See Understand team roles.

Flodesk sometimes renames its menus. If a label below does not match exactly, look for the closest one.

Step 1: Create an API key in Flodesk

  1. Log in to Flodesk.
  2. Open your account menu and go to Integrations → API keys.
  3. Click Create API key, name it PlayerMagick and copy the key.

Step 2: Connect Flodesk in PlayerMagick

  1. Go to Settings → Integrations.
  2. Click Connect an email tool and choose Flodesk.
  3. Paste the key into API key.
  4. Click Test and connect.

PlayerMagick connects one Flodesk account per PlayerMagick account. To use another Flodesk account, choose Replace key on the card.

Step 3: Send a gate's leads to Flodesk

  1. Open your video, click the Interactions tab and click the email gate.
  2. Under Send leads to, choose Flodesk and a Segment, or no segment.
  3. Choose whether Flodesk sends its double opt-in confirmation email to new subscribers.
  4. Click Save destination.
  • Tags: Flodesk has segments instead of tags, so a Flodesk gate has no tags. Use a segment.
  • Someone already in Flodesk is added to the segment. The double opt-in choice applies to new subscribers only.

Start and stop Flodesk workflows from what people watch

In Automations, add the action Start workflow or Remove from workflow and choose one of your active Flodesk workflows. Flodesk adds a person to a workflow again only if they finished it and the workflow allows repeat subscribers.

Other actions for Flodesk: Add to a segment, Remove from a segment and Update a field (a Flodesk custom field; Flodesk keeps text, so dates are written like 2026-10-28).

Recognise viewers from your Flodesk emails

Flodesk puts no subscriber code in its emails, only the email address. To recognise your Flodesk subscribers:

  1. In Automations → Recognise viewers from your emails, turn on Allow email links (pm_email) and choose your Flodesk connection.
  2. Add this to the end of the links in your Flodesk emails:

?pm_email={{ subscriber.email }}

The email address is then visible in the link, so it can end up in browser history and in your page's statistics tools. Send yourself a test email and use Check a link.

Good to know

  • Someone who unsubscribed, bounced, complained, was cleaned or archived in Flodesk is never added again. Leads shows Not added.
  • Speed: Flodesk allows 100 requests a minute; PlayerMagick spaces its requests to stay under it.

Error messages

MessageWhat to do
"Flodesk did not accept this key. Check that you copied the whole key."Copy the key again. Check that your Flodesk plan is a paid one.
"Flodesk didn’t answer. Try again in a minute."Try again in a minute.

All statuses and fixes: Fix an email tool error.

Was this article helpful?