How to Integrate Poptin with Customer.io
Emel DalabasmazPoptin’s documented Customer.io connector uses a Site ID, API key and Segment ID. Verify the destination contact, segment membership and submitted values separately after saving the connection.
Source: Poptin’s Customer.io guide, checked September 6, 2026. The troubleshooting checks below are editorial guidance, not results from a client account.
Prepare and connect
- Obtain the Site ID and API key from Customer.io’s API settings. The cited guide describes Account Settings → Integrations → Customer.io API; if your interface differs, confirm the equivalent credentials rather than substituting an unrelated key.
- Open the intended segment and copy its ID from the page URL.
- In Poptin, open the popup’s Edit Design → Email and Integrations → Add Integration → Customer.io.
- Enter the three values, choose Approve, then Next or Publish Changes to save.
Keep the credentials in the connector settings. Record the destination account and segment name alongside its ID so another team member can check the setup without needing the secret key.
Verify the received contact
The vendor says a successful connection creates an API test lead in Customer.io contacts. Finding that record does not by itself prove every field or segment condition is correct.
| Check | Evidence to inspect |
|---|---|
| Connection | Vendor test contact in the intended Customer.io destination |
| Live form | A new controlled submission from the published popup |
| Segment | Expected membership in the intended segment |
| Fields | The submitted name, email, phone and message values, where collected |
| Follow-up | Any separately configured automation and subscription state |
Use a test address you control and note the campaign and submission time. The documented field list does not establish support for every custom attribute. Test any additional requirement and confirm it with Poptin before relying on it.
Troubleshoot one stage at a time
If no contact arrives, compare the saved credentials and destination with the account you are inspecting. Confirm you tested the published campaign whose integration you changed. Do not assume the Segment ID is the most common cause without checking the actual result.
If a contact exists but segment membership differs, inspect the configured segment and its behavior. The cited guide does not specify support for every segment type or every existing-contact case. If a field is missing, compare the submitted input with the documented fields. If the contact and segment look correct but no message follows, investigate the automation separately.
Before retrying, check whether the earlier submission already created or updated a contact. Record any error and test time for support, without sharing the API key. Return to Poptin integrations for other destinations.
Questions before you decide
Frequently asked questions
Where should the API test lead appear after connecting Customer.io?
Poptin’s guide says its API test lead appears in Customer.io contacts after a successful integration. Check the intended segment and your own published-form submission separately.
About the author
SEO Executive at Flatart
Emel Dalabasmaz graduated in Advertising and Public Relations from Anadolu University. She began in social media and carried that grounding — content, brand communication and performance — into SEO. For more than ten years she has worked on growth for brands across a range of industries, pairing a communications perspective with data and technical analysis to build a digital presence that holds up over time. At Flatart, she has worked for more than ten years with over 250 brands and set up popups for more than 70% of them. She has tried the popup tools covered by PopupBuilder.io for agency customers and read G2 customer reviews as part of her product research.
- Education
- Advertising and Public Relations, Anadolu University
- Writes about
- Popup builders, Conversion rate optimization, On-site messaging, SaaS pricing research, SEO, Technical SEO, Content strategy, Digital marketing