# Custom trackers

- Custom trackers provide a JavaScript API for capturing leads from any event source.
- Use when form trackers or call trackers don’t fit your use case (e.g., AJAX submissions, button clicks, chat widgets).
- Developers can call the API with custom data and full attribution is automatically added.

## Creating a custom tracker

- Navigate to the ‘Trackers’ section of your container using the top menu.
- Click the “CUSTOM TRACKER” button to create a new tracker.
-

## Configuration options

**Tracker name** - A name to identify this tracker. Used to segment leads.

**Require email** - Marks leads without email addresses as invalid.

**Alert users** - Send email notifications to specified users when new leads arrive.

## JavaScript API

After creating a custom tracker, use the following JavaScript API to capture leads:

```javascript
document.createLead({
    email: "user@example.com",
    phone: "+1234567890",
    name: "John Smith",
    // Add any custom fields
    custom_field: "custom value"
});
```

- The `createLead()` function can be called anywhere on your page after the container snippet loads.
- Pass an object with any fields you want to capture.

## Data captured

In addition to your custom fields, the following are automatically captured:

- Google Analytics cookies (GA and GA4)
- Facebook tracking cookies (fbc, fbp)
- UTM parameters (source, medium, campaign, term, content)
- Google Click IDs (gclid, dclid)
- Referrer URL
- Device and browser information
- IP address and geolocation

## Common use cases

- **Chat widgets** - Capture leads when a chat conversation completes.
- **Forms not supported by the form tracker** - Track submissions from forms that don’t dispatch a ‘submit’ event.

## Testing

- Call `document.createLead()` from your browser console with test data.
- Verify the lead appears in your dashboard with all expected fields.
- Check that attribution data is correctly captured.