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
Log in to Privy.
Click Settings in the bottom-right corner.
Click API, then Create Token.
Name the token, turn on Read and Write Contacts, and set the expiration to No Expiration.
Copy the token.
Step 2: Connect Privy in Alia
In Alia, go to Integrations.
Find Privy and click Connect.
In Privy integration, paste your API token and click Create. Alia checks the token when you save.
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:
subscribedunless the visitor declined email marketing in the popup, otherwisenever_subscribedPhone number, with SMS consent:
subscribedunless the visitor declined SMS, otherwisenever_subscribedFirst name, if the popup collected a name
These custom fields:
Custom field | What it holds |
| The name of the popup the visitor signed up through |
| The name of the campaign the visitor saw |
| The discount code from the reward the visitor claimed |
| The reward's title, such as "10% off" |
| 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.
A visitor signed up again but their consent didn't change
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.






