Quick Start: From an Existing Provider
Already using Amplitude, PostHog, or RudderStack? Add Accoil as a destination in minutes.
If you already have a product analytics provider collecting events, you can route that data into Accoil without writing any code. Accoil has built-in integrations with Amplitude, PostHog, and RudderStack.
Prerequisites
You need an active Accoil account and an API key. Find your key under Account > General in the Accoil dashboard. Each product has its own key.
Amplitude
Amplitude has a native Accoil destination in its Data Catalog. Setup takes about two minutes.
- In Amplitude, go to Data > Catalog > Destinations and select Accoil.
- Create a sync, paste your Accoil API key, and click Test Connection.
- Under Map Properties, map your Amplitude user ID to
userId. - Toggle the sync to Enabled and save.
Events, user traits, and group data will begin streaming to Accoil immediately.
For full configuration details (event filtering, group mapping, property selection), see the Amplitude integration guide.
PostHog
PostHog has a community-maintained Accoil destination in its Data Pipelines.
Use the correct destination
PostHog lists two options. Select the destination labeled Accoil (not "Accoil Analytics"). The Accoil destination was built in coordination with our team and maps data correctly.
- In PostHog, go to Data Pipelines > Destinations > New Destination and select Accoil.
- Enter your Accoil API key.
- Click Create & enable.
PostHog events, identify calls, and group calls will flow into Accoil automatically.
For details on event filtering, trait handling, and blocked properties, see the PostHog integration guide.
RudderStack
RudderStack supports Accoil as a Cloud Mode streaming destination.
- In the RudderStack dashboard, go to Destinations > Add Destination and search for Accoil Analytics.
- Enter your Accoil API key (found under Account > General in Accoil).
- Save and enable the destination.
RudderStack forwards identify, group, track, page, and screen events to Accoil. Page and screen events are treated as track events.
For supported message types and trait mapping details, see the RudderStack integration guide.
How Accoil processes incoming data
Regardless of which provider you use, the same rules apply:
- identify calls create or update user profiles with traits.
- group calls create or update accounts and link users to them.
- track calls record event names only -- event properties are not stored.
All data is processed asynchronously. Events typically appear in Accoil within one to two minutes.