How to Set Up
Step 1: Get Your API Key
Log in to your Accoil workspace and navigate to Settings > Product > Overview. Copy your Ingestion API key from the right sidebar.
Step 2: Connect in Segment
In Segment, go to Connections > Catalog and search for Accoil Analytics.
Click Add Destination and choose the source you want to connect.
Paste your Accoil API key into the configuration.
Enable the destination.
Allow 8–24 hours for engagement metrics to begin appearing — Accoil needs at least one full day of event data to calculate scores.
What Gets Synced
Identify events — Create and update user profiles with traits like email, name, and role
Group events — Create and update account profiles with traits like plan, MRR, and status
Track events — Record product activity (event name and timestamp are used for engagement scoring)
Page and screen events — Sent to Accoil as track events
Good to Know
Use consistent identifiers. Keep
userIdandgroupIdvalues stable across all your event types.Group calls are essential for B2B. Without them, Accoil can't calculate account-level engagement scores.
Only the event name matters for track calls. Event properties aren't stored — use identify and group calls for user and account attributes.
Need More Help?
Visit our Developer Docs for event examples, supported actions, and detailed configuration options.