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

# Lead details

> How to open a lead in Octanist and qualify, win or lose it, set its value, won conversion and label, read its journey and history, add notes, and reopen, unqualify, hide or delete it.

Every lead has its own detail view. Here you give the lead its outcome and see where it came from.

## Open a lead

* On the [Leads page](https://octanist.com/docs/using-octanist/leads.md), click a row. The lead opens in a side panel with the tabs **Details**, **Journey**, **History** and **Notes**.
* Click **Open full page** in the panel to see the lead on its own page. The full page shows the details, the journey, and the history and notes side by side.

The top of the lead shows its status (**Open**, **Won** or **Lost**), a **Qualified** badge when it is qualified, the channels in its journey and how long ago it came in.

***

## Give a lead an outcome

Open leads have three buttons and a value field.

### Value

Type the value of the lead in the value field. For a qualified lead this is the expected value, for example what the deal is worth if it closes. For a won lead it is the actual revenue. The field uses your organization's currency.

### Marking a lead as qualified

Click **Qualified** (the star). Octanist records the qualification with the current value and sends the qualified conversion to your connected ad platforms and analytics integrations.

Qualify leads that are a good fit but have not bought yet. It tells your ad platforms which campaigns bring good leads long before a deal closes.

### Marking a lead as won

Click **Won**. A won lead needs a value above 0. If the value field is empty, Octanist asks you to add a value first.

Octanist then sends the won conversion with its value to your connected platforms.

Under **Won conversion** in the Details tab you can pick which conversion is sent when the lead is won. By default this is your default won conversion, such as **Converted (Default)**. Manage conversions under [**Settings > Conversions**](https://octanist.com/docs/settings/conversions.md). Conversion names must match the ones in your ad platforms.

### Marking a lead as lost

Click **Lost**.

If lost reasons are turned on under [**Settings > Lost Reasons**](https://octanist.com/docs/settings/labels-and-lost-reasons.md), Octanist asks you to pick a reason and lets you add optional notes. The default reasons are Bad timing, Budget constraints, No response, Not a good fit and Went with competitor. You can change them in the settings.

Lost reasons show on the lead, in its history and in the **Why leads were lost** card on the [Dashboard](https://octanist.com/docs/using-octanist/dashboard.md#insight-cards). Use them to spot patterns, such as many leads lost on budget from one campaign.

If lost reasons are turned off, the lead is marked lost with one click.

> [!WARNING]
>
> Qualifying and winning send conversions to your ad platforms. That cannot be undone in the ad platforms. Set up your [outgoing integrations](https://octanist.com/docs/outgoing-integrations/google-ads.md) before you start qualifying, because some platforms, such as Meta and Google Analytics, do not accept conversions for the past.

***

## Details tab

The Details tab has these sections:

* **Contact information**: Name, Email, Phone and External lead ID. Click **Edit** to change them. An external lead ID must be unique within your organization.
* **Lifecycle**: when the lead was Created, Updated and Qualified, and when it Expires.
* **Label**: give the lead one label, such as "Hot Lead" or "Follow Up". Labels are managed under [**Settings > Labels**](https://octanist.com/docs/settings/labels-and-lost-reasons.md), where you can also turn them on or off.
* **Won conversion**: see above.
* **Source & Location**: the website, form name, entry point, landing page and page path where the lead came in.
* **Custom data**: every extra field from the form or API, such as answers to form questions.
* The lost reason, the original note sent with the lead, and call details for leads from [call tracking](https://octanist.com/docs/incoming-integrations/call-tracking.md), when present.

At the bottom are the actions that undo or remove things:

| Action | What it does |
| - | - |
| **Reopen Lead** | Changes a won or lost lead back to open. This also clears its qualification. |
| **Unqualify Lead** | Clears the qualification of an open lead without reopening it. |
| **Delete Lead** | Permanently removes the lead and its history. |

> [!WARNING]
>
> Reopening or unqualifying can send the lead through your integrations again. That can cause double or wrong conversions in your ad platforms. Only do it when you have to.

Only delete test leads and duplicates. Keep real leads, also bad ones: they make your Dashboard numbers and your ad platform targeting better. To clean up the list without deleting, use **Hide from leads list**.

***

## Journey

The **Journey** tab shows the website visits of the lead before it converted. It is only available for leads captured with the [tracking pixel](https://octanist.com/docs/incoming-integrations/pixel.md).

It shows:

* The number of **Sessions** and page views, and when the visitor was first and last seen.
* Each session with its pages, device and entry details.
* **Channels in journey**.
* **Click IDs** found in the journey, such as `gclid`, `fbc` or `msclkid`.
* **UTM Parameters**.
* **Consent**: the consent signals given by the visitor.
* Google Ads attribution details, when available.

Use the journey to check why a lead is attributed to a channel, or why a conversion was or was not sent to a platform.

***

## History

The **History** tab lists everything that happened to the lead, newest first. For example:

* When the lead was created.
* Status changes, qualification and value changes, and who made them.
* Hiding and unhiding.
* Notes.
* Every attempt to send the lead to an integration: **Synced**, **Sync Failed** or **Skipped**, with the reason.
* Updates from connected CRMs and webhooks, including failed and skipped updates.

When a conversion does not show up in an ad platform, start here.

### Activity page

To see history across all your leads, open **Activity** in the sidebar. **Activity history** lists every event, 50 per page. Filter it by type, such as Leads Created, Status Changes, Value Updates, Notes, Sync Success, Sync Failed, Sync Skipped, External Updates, External Update Failures or External Webhooks.

***

## Notes

The **Notes** tab holds internal notes, such as "Called, will reply in two weeks". Type a note and click **Add Note**. Notes also show in the History tab and in the **Latest Note** column of the leads list.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.