Skip to main content

Integrate Alia with Privy

Connect Privy so Alia signups become Privy contacts with consent, discount codes, and quiz answers.

Written by Rob D

Connect Privy so each visitor who signs up through an Alia popup becomes a Privy contact, with their email and SMS consent, discount code, and quiz answers. Privy has no lists, so every contact goes to your Privy Contacts.

Before you begin

You'll need a Privy API token with:

  • Read and Write Contacts permission

  • No Expiration, so the connection doesn't stop working later

Step 1: Create a Privy API token

  1. Log in to Privy.

  2. Click Settings in the bottom-right corner.

  3. Click API, then Create Token.

  4. Name the token, turn on Read and Write Contacts, and set the expiration to No Expiration.

  5. Copy the token.

Step 2: Connect Privy in Alia

  1. In Alia, go to Integrations.

  2. Find Privy and click Connect.

  3. In Privy integration, paste your API token and click Create. Alia checks the token when you save.

  4. The Privy card shows Connected.

To replace the token later, click Edit on the Privy card and then Update. To disconnect, click Disable.

What Alia sends to Privy

  • Email, with email consent: subscribed unless the visitor declined email marketing in the popup, otherwise never_subscribed

  • Phone number, with SMS consent: subscribed unless the visitor declined SMS, otherwise never_subscribed

  • First name, if the popup collected a name

  • These custom fields:

Custom field

What it holds

alia_popup

The name of the popup the visitor signed up through

alia_campaign

The name of the campaign the visitor saw

alia_discount_code

The discount code from the reward the visitor claimed

alia_discount_text

The reward's title, such as "10% off"

alia_discount_expiration

When the discount code expires

Quiz questions

The visitor's answer, under the exact question text

Form answers

Anything a form collects under an Integration field name, or sets under When form is submitted

For a quiz question with several selected answers, only the first answer is saved.

Email, phone, and consent are sent once

Alia sends a contact's email address, phone number, and consent only the first time. Later signups update the first name and custom fields, but don't change the email, phone number, or consent.

If the phone number a visitor enters already belongs to a different Privy contact, Alia still creates or updates the contact for their email address, without the phone number.

When contacts are sent

A contact is sent when the visitor submits a form with an email or phone number. If the form's Immediately subscribe users to CRMs setting is off, Alia waits until the visitor submits another form, claims a reward, or has been inactive for a few minutes. Custom fields that arrive later, such as a reward claimed after signing up, are added to the same contact.

Every popup uses the same Privy settings. To build segments or automations for specific popups, use the alia_popup and alia_campaign custom fields.

💡 Note: If the Privy widget is on your store, Alia also identifies each new signup's email to it in the browser. This is the Privy checkbox under Third-party pixels in Settings > Tracking, and it's on by default.

💡 Tip: If you're moving from Privy's own popups to Alia, turn off Privy's signup forms so visitors aren't asked twice and don't get two welcome emails.

FAQ

A contact has an email but no phone number

The phone number is probably already on another Privy contact. When Privy won't accept the phone number, Alia leaves it off and keeps the rest.

Alia only sends email, phone, and consent the first time. Later signups update custom fields only.

The connection stopped working

Check that the token in Privy hasn't expired or lost its contacts permission, then paste a new one with Edit.

Still have questions?

Start a chat from inside the Alia app, or use the chat in our Help Center.

Did this answer your question?