Start Here 👋
Webhooks are a simple way to automatically send event data from one app to another in real-time. Most applications support webhooks, making it easy to track actions like form submissions, purchases, or leads directly in Cometly—even if the app doesn’t have a built-in Cometly integration.
What Can You Do with Cometly Webhooks?
Cometly Webhooks empower you to:
Send Event Data from Any Application
Seamlessly connect your favorite apps to Cometly, even those without native integrations.Track the Events That Matter
Choose specific events like form submissions, purchases, or lead updates to monitor in real-time.Map Data to Cometly Fields
Easily match your app’s data fields (e.g., email, event time) to Cometly’s tracking system for accurate reporting.Filter Out Unnecessary Data
Use filters to ensure only the most relevant data is processed, keeping your analytics clean and focused.
💡 Tip For Contact Data Enrichment: If the Cometly pixel is only capturing the email address field on your form (and not the first name, last name, and phone number), when you send event data to Cometly and map the first name, last name, and phone number, the contact in Cometly will be enriched with that information.
How to Send Event Data Using Webhooks
💡 Tip: Set up one event at a time to stay organized and follow your tracking plan.
Go to the Space Setup page.
Click Add Events to start sending event data.
Where it asks you where you would like to send your event from, choose Webhooks and click Next.
After choosing Webhooks you will be able to choose from a pre-configured event or create a new event.
On the next page you will have a Webhook URL that you can place in any app or integration to send event data to Cometly.
Copy the webhook URL and paste it into your app to start sending data.
Once you've set it up, click Check for Data.
Wait for your app to send an event. If no data shows up right away, don't worry, you can return to this step later once events are sent.
If no data was sent yet, you can click Skip and map data later, and come back later to Check for Data again.
To come back to that specific Webhook, you can navigate to Events Manager and you will see your Event configuration In draft. Hover over the event and click the gear cog to navigate back to the Webhook URL to check for data.
When data is received, you will see requests with the payload data:
Click the down arrow to open the request and view data. Click Continue With Select Record to continue to the next step.
How to Configure Mapping
Easily map your app’s data fields to Cometly fields for precise tracking. This step ensures that the event data you send, such as email addresses, event times, or other custom data, aligns with Cometly’s reporting system.
Mapping Fields
Select the Cometly field you want to map (e.g., Email or Event Time).
Choose the corresponding field from your app’s data (e.g.,
email@example.com).Repeat this process to map additional fields as needed. You can add as many fields as necessary to fully capture your event data.
Important Notes
Email and Event Time are required fields.
If you don’t have the event time available, select the dynamic option for Event Time. This will automatically use the time the event is received.
Adding More Fields
If your event includes additional data points (e.g., user IDs, product names, or custom metrics), simply click Add Field and repeat the mapping process.
Once all fields are mapped and formatted, click Continue to finalize your setup and start tracking seamlessly with Cometly.
Using Formatting Options
Cometly's formatting options help ensure your data is consistent and accurate for reporting. Here's how you can use these tools for date and amount fields:
Date Fields
Customize Date Format: Match your system’s style (e.g.,
MM/DD/YYYY,YYYY-MM-DD).Timezone Conversion: Automatically convert timestamps to a specific timezone for standardized reporting.
Amount Fields
Adjust Decimals: Increase or decrease the number of decimal places.
Perform Calculations: Add, subtract, multiply, or divide by:
A fixed value you specify.
A dynamic value from your payload (e.g., a tax or fee).
Currency Conversion: Convert amounts from one currency to another using your selected conversion settings.
How to Setup Filters
Setting up filters is optional but can help refine your data. To add filters:
Choose your desired filtering options.
If the data meets your filter criteria, you'll see a green confirmation box.
If the data doesn't pass the filters, you'll be notified that it would not proceed.
Filters provide an easy way to ensure only relevant data is processed.
Activate your Webhook
After activating your webhook, it will appear as toggled on and marked as active in the Events Manager.
Important: Any test data sent before the webhook was activated will not be processed or appear in your reports.
You can manage the webhook at any time by toggling it on or off. If the webhook is toggled off, you will also have the option to delete it.