Connect FunnelFox to Adapty Mail

FunnelFox is one of Adapty Mail’s entry points — use it when you acquire and charge users through FunnelFox web funnels. FunnelFox already holds their email addresses, purchases, and subscription events, so connecting it takes no SDK work and no requests of your own.

The connection is one-way. FunnelFox pushes data to Adapty Mail; it never reads your campaigns back, and it never sends email itself.

What FunnelFox sends

• Profiles and email addresses, whenever a funnel collects an email.

• Identifiers: the recipient’s FunnelFox profile ID, and the custom user ID your funnel holds for them, if it has one. On the profile page they appear under External Profile IDs, as a FunnelFox row and a Custom row.

• Purchase history: subscriptions, renewals, and one-time purchases. Refunds arrive as negative amounts.

• Subscription events: cancellations, reactivations, billing issues, and expirations. These are what place each user in a flow.

• Profile attributes: country, device, OS, platform, and locale — all five are segment filters. FunnelFox reads the last four from the browser’s user agent. It also sends the timezone, which sets when the recipient receives email but isn’t a filter. It never sends an app version, so that filter stays empty for funnel users.

• Funnel context, stored as custom attributes on the profile under these keys:

  • fnlfx_funnel_id: the funnel that collected the email.
  • fnlfx_session_id: the funnel session.
  • fnlfx_experiment_id: the funnel experiment, if the user was in one.
  • email_consent: whether the user agreed to receive email in the funnel. The value is the text "true" or "false", so a segment filter on it compares text.

  To pass one of these values to a checkout page, add its placeholder to the link — for example, {custom_attribute.fnlfx_session_id}. See placeholders.

Data reaches Adapty Mail within about a minute of the funnel event.

Connect FunnelFox

Finish the rest of your Adapty Mail setup first — see Get started with Adapty Mail. Until a flow exists, nothing you send produces email.

1. In Adapty Mail, go to Settings > Project and copy the Secret key.
2. In FunnelFox, go to Integrations > Adapty Mail.
3. Paste the key and save.

For the FunnelFox side of the setup, see FunnelFox’s integration guide.

After you connect

On a profile’s page, External Profile IDs shows a FunnelFox row with the ID FunnelFox uses for that person. A profile reported by more than one source carries a row for each, so you can see every source that knows them.

When you build a checkout link by hand, {funnelfox.external_profile_id} resolves to the recipient’s profile ID in FunnelFox. Email destinations lists every placeholder.

Use it alongside another entry point

You can run FunnelFox and another entry point at once. Adapty Mail matches people by email address. Two sources reporting the same address land on one profile; two different addresses create separate profiles, even when customer_user_id is identical.