Overview
There are two ways to send event data to Cometly:| Method | Best For | Complexity |
|---|---|---|
| Webhooks | Most integrations | Low - no code required |
| API | Custom implementations | Medium - requires development |
Webhooks (Recommended)
Webhooks are the easiest way to send data to Cometly. They enable automated, real-time data transmission from external applications without writing any code.Benefits
- No code required - Configure entirely through the Cometly UI
- Works with most apps - Any platform that supports webhooks (HubSpot, Stripe, ClickFunnels, HighLevel, and many more)
- Built-in field mapping - Match your app’s data fields to Cometly through a visual interface
- Data filtering - Process only relevant events based on criteria you define
- Data transformation - Format dates, convert currencies, and perform calculations automatically
How It Works
- Get a unique webhook URL from Cometly (Space Setup → Add Events)
- Add the URL to your external application’s webhook settings
- Map your app’s fields to Cometly fields
- Activate the webhook
API
The API is for custom implementations where you need full control over when and how events are sent.When to Use the API
- Building a custom integration not supported by webhooks
- Server-side event tracking
- Programmatic event creation from your own application
- Bulk data operations via exports
Getting Started
- Generate an API key
- Use the Create Event endpoint to send events
- Include identification parameters (
email,comet_token, orfingerprint+ip)
Which Should I Use?
Use webhooks if your platform supports them. They’re faster to set up, require no code, and include built-in data transformation features.
- Your platform doesn’t support webhooks
- You need to send events from server-side code
- You’re building a custom application that requires programmatic control