> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useorbitcrm.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Cometly Integration
> First-party attribution for accurate lead tracking
> [!NOTE]
>
> This integration requires a **Pro** plan.
[Visit Cometly](https://www.cometly.com/?comet_custom=orbitai)
## Overview
Cometly provides first-party attribution tracking that helps you accurately measure which ads and campaigns are driving your form submissions. OrbitForms offers two ways to integrate with Cometly: **Pixel Tracking** for client-side attribution and **Server-Side Integration** for sending conversion events directly to Cometly's API.
> [card] First-Party Attribution
>
> Accurate tracking that bypasses ad blockers
> [card] Campaign Insights
>
> See which ads drive form submissions
> [card] Real-Time Syncing
>
> Instant attribution data on form submit
> [card] Workflow Integration
>
> Use with AI qualification and enrichment
## Choose Your Integration Method
Cometly can be set up in two ways. Choose based on your needs:
> [card] Pixel Tracking
>
> Add the Cometly pixel to your forms for client-side tracking. The pixel loads when your form is viewed and captures attribution data.
>
> **Best for:**
>
> * Quick setup with minimal configuration
> * Capturing page views and form interactions
> * First-party domain tracking setup
>
> [Set up Pixel Tracking](#pixel-tracking-setup)
> [card] Send Form Data to Cometly
>
> Send form submissions as events to Cometly. Track the source of every lead and feed conversion data back to your ad platforms.
>
> **Best for:**
>
> * Bypassing ad blockers completely
> * Custom field mapping to Cometly properties
> * Advanced workflows with filtering/enrichment
>
> [Set up Form Data Tracking](#send-form-data-to-cometly)
### Integration Page vs. Workflows: Which Should You Use?
> [card] Integration Page
>
> Use the Integration page when you want to send **all form submissions** directly to Cometly without any filtering.
>
> * Simple 1:1 form-to-Cometly mapping
> * No need for lead qualification first
> * Fastest setup for basic tracking
> [card] Workflows
>
> Use Workflows when you need **filtering, enrichment, or AI qualification** before sending to Cometly.
>
> * Filter by lead score or qualification
> * Enrich leads before sending (Clay, etc.)
> * Use AI SDR qualification first
> * Route different leads to different events
>
> [Learn more about Workflows](#using-cometly-with-workflows)
## Pixel Tracking Setup
Add the Cometly tracking pixel to your forms to capture attribution data when visitors view and submit your forms.
### Step 1: Get Your Pixel Code from Cometly
**1. Log in to Cometly**
Go to cometly.com and sign in to your account. Navigate to your Cometly dashboard.
**2. Go to Space Setup**
Click on "Space Setup" in the left sidebar menu. This is where your tracking pixel lives.
**3. Find "Tracking Pixel"**
Look for the Tracking Pixel section and click to expand it. You'll see your unique pixel code here.
**4. Copy the pixel code**
Copy the full script tag. It should look like:
```html theme={null}
```
> [!NOTE]
>
> For detailed screenshots from Cometly: [Install & Verify Cometly Pixel →](https://help.cometly.com/en/articles/10340439-install-verify-cometly-pixel)
### Step 2: Add the Pixel to Your Form in OrbitForms
**1. Open your form in OrbitForms**
Go to your dashboard and click on the form you want to track.
**2. Click the 'Integrate' tab**
In the form editor, find and click the "Integrate" tab at the top.
**3. Find the Cometly section**
Scroll down to find "Cometly" under the Tracking & Analytics section.
**4. Paste your pixel code**
Paste the complete script tag you copied from Cometly into the "Cometly Pixel Code" field.
**5. Save your form**
Click the Save button. The pixel will now load whenever your form is viewed.
> [!WARNING]
>
> **Important:** Paste the complete script tag, not just the URL. The code must start with ``.
## Send Form Data to Cometly
Send your form submission data directly to Cometly as events. This allows you to track the exact source of every form submission—which ads, campaigns, keywords, and channels are driving your leads—and feed back accurate conversion data to your ad platforms' conversion APIs (Meta CAPI, Google Ads, TikTok, etc.) for better optimization and attribution.
> [!NOTE]
>
> **Before you begin:** You'll need to create and configure events in Cometly first. See Cometly's guide: [Creating & Configuring Events in Cometly →](https://help.cometly.com/en/articles/8950752-creating-configuring-events)
### Step 1: Get Your Cometly API Key
**1. Log in to Cometly**
Go to cometly.com and sign in to your account.
**2. Go to Integrations**
Click "Integrations" in the left sidebar menu.
**3. Open API settings**
Click on "API" to open the API configuration page.
**4. Create a new API key**
Click "Create API Key" and name it "OrbitForms" for easy identification.
**5. Copy your API key**
Copy the generated API key. You'll need this in the next step.
### Step 2: Connect Cometly in OrbitForms
**1. Go to Integrations in OrbitForms**
From your dashboard, click "Integrations" in the left sidebar.
**2. Find Cometly**
Scroll down or search for "Cometly" in the integrations list.
**3. Click to configure**
Click on the Cometly card to open the configuration panel.
**4. Paste your API key**
Paste the API key you copied from Cometly into the "API Key" field.
**5. Click Connect**
Click the "Connect Cometly" button. You should see a success message.
### Step 3: Configure a Form Mapping
**1. Select a form to configure**
After connecting, you'll see a list of your forms. Click on the form you want to send events for.
**2. Select the event type**
Choose which Cometly event to trigger when the form is submitted. Options include Lead Generated, Sign Up, Purchase, or custom events.
**3. Map the Email field (required)**
Find a form field that contains an email address and map it to "Email". This is required for Cometly attribution.
**4. Map additional fields (optional)**
Map other form fields to Cometly properties like Full Name, Phone, Amount, etc.
**5. Click Save Mapping**
Click "Save Mapping" to save your configuration. The form will now send events to Cometly.
### Using Custom Events
> [!WARNING]
>
> **Important: New Custom Events**
>
> If you just created a new custom event in Cometly, it needs to have **at least one event tracked** before it will appear in the "Custom Events" dropdown in OrbitForms. Until then, you can select it from the "Custom Event Slots" section using its event number (e.g., `custom_event_3`).
>
> To find your custom event number in Cometly, look at the event number shown next to your custom event name (e.g., `custom_event_27`). Select this from the "Custom Event Slots" dropdown in OrbitForms.
## Using Cometly with Workflows
For advanced use cases, add Cometly as a destination in your workflows. This gives you more control over which submissions get sent to Cometly.
Use workflows when you need to:
* Send events only for qualified leads (after AI agent qualification)
* Include enriched data in your Cometly events (from Clay, Clearbit, etc.)
* Route different form submissions to different Cometly events
* Combine with other destinations like your CRM in a single flow
* Use AI SDR to classify leads before sending to Cometly
### Adding Cometly to a Workflow
**1. Create or open a workflow**
Go to Workflows in your dashboard and create a new workflow or open an existing one.
**2. Add a trigger**
Set up a Form Submission trigger for the form(s) you want to track.
**3. Add any intermediate steps (optional)**
Add AI Agent for qualification, Enrichment nodes, or Filter nodes as needed.
**4. Add Cometly destination**
Click the + button and select Cometly from the destinations list.
**5. Configure the Cometly node**
Select the event type and map your fields. You can use enriched data from previous nodes.
**6. Save and activate**
Save your workflow and toggle it to Active. Events will now flow through your workflow.
> [!TIP]
>
> **Example: Qualified Leads Only** — A common workflow that only sends qualified leads to Cometly:
>
> Form Submission → AI Agent (Qualify) → Filter (Score > 70) → Cometly
## Verifying Your Events
After setting up either integration method, verify that events are being received in Cometly:
**1. Submit a test form**
Fill out and submit your form with test data to trigger an event.
**2. Go to Cometly Events Log**
In Cometly, navigate to Events → Events Log to see incoming events.
**3. Verify the event data**
Check that your event appears with the correct event name and field data. Events typically appear within a few seconds.
## Troubleshooting
> [accordion] Pixel not firing?
>
> Make sure you pasted the complete script tag including the opening and closing script tags. The URL must use HTTPS. If you're using first-party domain tracking, ensure your domain is properly configured in Cometly.
> [accordion] Custom event not appearing in dropdown?
>
> New custom events need at least one tracked event before appearing in the "Custom Events" section. Use the "Custom Event Slots" section to select the event by its number (e.g., custom\_event\_3) instead.
> [accordion] Events not showing in Cometly?
>
> There may be a short delay before events appear. If events still don't show after a few minutes, check that your API key is correct and that you've mapped the required Email field.
> [accordion] "Email field required" error?
>
> Cometly requires an email address for attribution matching. Make sure you map one of your form fields to the Email property before saving.
> [accordion] Duplicate events in Cometly?
>
> If you're seeing duplicate events, you may have both the Integration Page and a Workflow configured for the same form. Choose one method and disable the other to avoid duplicates.
## Resources
> [card] [Creating & Configuring Events](https://help.cometly.com/en/articles/8950752-creating-configuring-events)
>
> Cometly event setup guide
> [card] [Install & Verify Cometly Pixel](https://help.cometly.com/en/articles/10340439-install-verify-cometly-pixel)
>
> Pixel installation guide
> [card] [Cometly API Documentation](https://docs.cometly.com/api-reference/endpoint/create-event)
>
> API reference
> [card] [Cometly Website](https://www.cometly.com/?comet_custom=orbitai)
>
> Visit Cometly
***
### Track the Source of Every Form Submission
See exactly where every lead comes from: ads, campaigns, keywords, and channels. No manual setup or guesswork.
* Automatically capture UTM parameters, referrers, and ad IDs on every submission
* Connect form fills to the full customer journey, not just the last click
* Attribute leads and revenue back to the exact ad or channel that drove them
* Works across paid ads, organic, email, and direct traffic
* First-party tracking built for accuracy, privacy, and reliability
[Start Tracking With Cometly](https://www.cometly.com/?comet_custom=orbitai)
*OrbitForms integrates seamlessly with Cometly*
***
**Ready to Track Your Forms?** Set up Cometly in minutes and start measuring your form conversions with first-party attribution. [Get Started](https://app.useorbitcrm.ai/signin)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.