Skip to content
05

Reference

When to use the API

Choose between file uploads, one-click connectors and the API, and what each API endpoint is for.

  1. 01When to use the API
  2. 02Universal API
  3. 03Intents and events
  4. 04Scheduled sync
  5. 05Export API
  6. 06Troubleshooting
  7. 07Security and compliance
  8. 08Glossary
  9. 09Changelog
You want toUse
Load history, or run a one-off analysisA file upload
Connect IntercomThe one-click Intercom connector
Bring in another tool (each has a guide; most mean running a small script on your side)The integration guides
Send messages from your own systems or any vendor’s APIThe universal API
Send bot intents, or events such as clicks and purchasesIntents and events
Run a guide’s code on a scheduleScheduled sync
Pull your Dimensions out into your own systemsThe Export API

Business data (accounts, orders, renewals) comes in by file upload only today, under Data Sources > Structured data. An API for it is on the roadmap. See Join business data.

  • Tracker key. Each source in Data Sources has its own key, shown in the source’s integration instructions. For the universal API, add the source with the Universal API tile. See Your API key.
  • Export API key. In Settings. See Export API.

Stuck? Email [email protected] with the source name and a sample payload.