> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitforms.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cometly Integration

> First-party attribution for accurate lead tracking

<img src="https://mintcdn.com/orbitai-d647f397/xAyOn7AVz_trk1Dg/_images/integrations/cometly.png?fit=max&auto=format&n=xAyOn7AVz_trk1Dg&q=85&s=dbee6b073b6cba32497e1421385ed27f" alt="Cometly" width="56" height="56" data-path="_images/integrations/cometly.png" />

<Note>This integration requires a **Pro** plan.</Note>

[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.

<CardGroup cols={2}>
  <Card title="First-Party Attribution" icon="bullseye">
    Accurate tracking that bypasses ad blockers
  </Card>

  <Card title="Campaign Insights" icon="chart-bar">
    See which ads drive form submissions
  </Card>

  <Card title="Real-Time Syncing" icon="bolt">
    Instant attribution data on form submit
  </Card>

  <Card title="Workflow Integration" icon="code-branch">
    Use with AI qualification and enrichment
  </Card>
</CardGroup>

## Choose Your Integration Method

Cometly can be set up in two ways. Choose based on your needs:

<CardGroup cols={2}>
  <Card title="Pixel Tracking" icon="desktop">
    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>

  <Card title="Send Form Data to Cometly" icon="server">
    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)
  </Card>
</CardGroup>

### Integration Page vs. Workflows: Which Should You Use?

<CardGroup cols={2}>
  <Card title="Integration Page" icon="gear">
    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>

  <Card title="Workflows" icon="code-branch">
    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)
  </Card>
</CardGroup>

## 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

<Steps>
  <Step title="Log in to Cometly">
    Go to cometly.com and sign in to your account. Navigate to your Cometly dashboard.
  </Step>

  <Step title="Go to Space Setup">
    Click on "Space Setup" in the left sidebar menu. This is where your tracking pixel lives.
  </Step>

  <Step title="Find &#x22;Tracking Pixel&#x22;">
    Look for the Tracking Pixel section and click to expand it. You'll see your unique pixel code here.
  </Step>

  <Step title="Copy the pixel code">
    Copy the full script tag. It should look like:

    ```html theme={null}
    <script src="https://t.cometlytrack.com/e?uid=YOUR_ID"></script>
    ```
  </Step>
</Steps>

<Info>
  For detailed screenshots from Cometly: [Install & Verify Cometly Pixel →](https://help.cometly.com/en/articles/10340439-install-verify-cometly-pixel)
</Info>

### Step 2: Add the Pixel to Your Form in OrbitForms

<Steps>
  <Step title="Open your form in OrbitForms">
    Go to your dashboard and click on the form you want to track.
  </Step>

  <Step title="Click the 'Integrate' tab">
    In the form editor, find and click the "Integrate" tab at the top.
  </Step>

  <Step title="Find the Cometly section">
    Scroll down to find "Cometly" under the Tracking & Analytics section.
  </Step>

  <Step title="Paste your pixel code">
    Paste the complete script tag you copied from Cometly into the "Cometly Pixel Code" field.
  </Step>

  <Step title="Save your form">
    Click the Save button. The pixel will now load whenever your form is viewed.
  </Step>
</Steps>

<Warning>
  **Important:** Paste the complete script tag, not just the URL. The code must start with `<script` and end with `</script>`.
</Warning>

## 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.

<Info>
  **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)
</Info>

### Step 1: Get Your Cometly API Key

<Steps>
  <Step title="Log in to Cometly">
    Go to cometly.com and sign in to your account.
  </Step>

  <Step title="Go to Integrations">
    Click "Integrations" in the left sidebar menu.
  </Step>

  <Step title="Open API settings">
    Click on "API" to open the API configuration page.
  </Step>

  <Step title="Create a new API key">
    Click "Create API Key" and name it "OrbitForms" for easy identification.
  </Step>

  <Step title="Copy your API key">
    Copy the generated API key. You'll need this in the next step.
  </Step>
</Steps>

### Step 2: Connect Cometly in OrbitForms

<Steps>
  <Step title="Go to Integrations in OrbitForms">
    From your dashboard, click "Integrations" in the left sidebar.
  </Step>

  <Step title="Find Cometly">
    Scroll down or search for "Cometly" in the integrations list.
  </Step>

  <Step title="Click to configure">
    Click on the Cometly card to open the configuration panel.
  </Step>

  <Step title="Paste your API key">
    Paste the API key you copied from Cometly into the "API Key" field.
  </Step>

  <Step title="Click Connect">
    Click the "Connect Cometly" button. You should see a success message.
  </Step>
</Steps>

### Step 3: Configure a Form Mapping

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Map additional fields (optional)">
    Map other form fields to Cometly properties like Full Name, Phone, Amount, etc.
  </Step>

  <Step title="Click Save Mapping">
    Click "Save Mapping" to save your configuration. The form will now send events to Cometly.
  </Step>
</Steps>

### 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.
</Warning>

## 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

<Steps>
  <Step title="Create or open a workflow">
    Go to Workflows in your dashboard and create a new workflow or open an existing one.
  </Step>

  <Step title="Add a trigger">
    Set up a Form Submission trigger for the form(s) you want to track.
  </Step>

  <Step title="Add any intermediate steps (optional)">
    Add AI Agent for qualification, Enrichment nodes, or Filter nodes as needed.
  </Step>

  <Step title="Add Cometly destination">
    Click the + button and select Cometly from the destinations list.
  </Step>

  <Step title="Configure the Cometly node">
    Select the event type and map your fields. You can use enriched data from previous nodes.
  </Step>

  <Step title="Save and activate">
    Save your workflow and toggle it to Active. Events will now flow through your workflow.
  </Step>
</Steps>

<Tip>
  **Example: Qualified Leads Only** — A common workflow that only sends qualified leads to Cometly:

  Form Submission → AI Agent (Qualify) → Filter (Score > 70) → Cometly
</Tip>

## Verifying Your Events

After setting up either integration method, verify that events are being received in Cometly:

<Steps>
  <Step title="Submit a test form">
    Fill out and submit your form with test data to trigger an event.
  </Step>

  <Step title="Go to Cometly Events Log">
    In Cometly, navigate to Events → Events Log to see incoming events.
  </Step>

  <Step title="Verify the event data">
    Check that your event appears with the correct event name and field data. Events typically appear within a few seconds.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="&#x22;Email field required&#x22; 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>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Resources

<CardGroup cols={2}>
  <Card title="Creating & Configuring Events" icon="gear" href="https://help.cometly.com/en/articles/8950752-creating-configuring-events">
    Cometly event setup guide
  </Card>

  <Card title="Install & Verify Cometly Pixel" icon="check" href="https://help.cometly.com/en/articles/10340439-install-verify-cometly-pixel">
    Pixel installation guide
  </Card>

  <Card title="Cometly API Documentation" icon="code" href="https://docs.cometly.com/api-reference/endpoint/create-event">
    API reference
  </Card>

  <Card title="Cometly Website" icon="globe" href="https://www.cometly.com/?comet_custom=orbitai">
    Visit Cometly
  </Card>
</CardGroup>

***

### Track the Source of Every Form Submission

<img src="https://mintcdn.com/orbitai-d647f397/T1yKN7sdBmMTM8cv/_images/integrations/cometlypromo.svg?fit=max&auto=format&n=T1yKN7sdBmMTM8cv&q=85&s=fb9e2c4c818e07558f2bf326c55926e5" alt="Cometly" width="120" height="28" data-path="_images/integrations/cometlypromo.svg" />

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://orbitforms.ai/signin)