# ownyourclick documentation

> ownyourclick is lead tracking and a CRM in your Google Sheet, for anyone who gets leads online. This file is the complete documentation from https://ownyourclick.com/docs: how to use every feature, step by step, and the API. Button and tab names are written exactly as they appear in the app, in **bold**.

If you're an AI assistant helping someone use ownyourclick: answer from this file, use the exact button and tab names it gives, and send people to support@ownyourclick.com for anything it doesn't cover. Pricing: https://ownyourclick.com/pricing.

## Contents

- Start here: [Getting started](https://ownyourclick.com/docs#start)
- Get leads: [Pages](https://ownyourclick.com/docs#pages), [Tracking code](https://ownyourclick.com/docs#tracking-code), [UTM Links](https://ownyourclick.com/docs#utm-links), [Create Form](https://ownyourclick.com/docs#lead-forms)
- Work your leads: [Leads](https://ownyourclick.com/docs#leads), [Hot %](https://ownyourclick.com/docs#hot-score), [Google Sheets](https://ownyourclick.com/docs#sheets), [Statuses & automations](https://ownyourclick.com/docs#statuses), [Payments](https://ownyourclick.com/docs#payments)
- Reach out: [WhatsApp](https://ownyourclick.com/docs#whatsapp), [Emails with Claude or ChatGPT](https://ownyourclick.com/docs#emails-with-ai)
- Your account: [White label](https://ownyourclick.com/docs#white-label), [Team](https://ownyourclick.com/docs#team), [Workspaces](https://ownyourclick.com/docs#workspaces), [Plans & billing](https://ownyourclick.com/docs#billing)
- API and webhooks: [Connect your AI (MCP)](https://ownyourclick.com/docs#mcp), [API: get started](https://ownyourclick.com/docs#api), [API: read leads](https://ownyourclick.com/docs#api-leads), [API: change a status](https://ownyourclick.com/docs#api-status), [API: tags](https://ownyourclick.com/docs#api-tags), [API: links, visits, forms](https://ownyourclick.com/docs#api-links), [API: emails](https://ownyourclick.com/docs#api-email), [Webhooks](https://ownyourclick.com/docs#webhooks), [Troubleshooting](https://ownyourclick.com/docs#help)

## Getting started

What ownyourclick does, the words it uses, and how to go from sign-up to your first lead in a few minutes.

ownyourclick is lead tracking and a CRM in your Google Sheet, for anyone who gets leads online. You add a small tag to the landing page you already have, and every lead that fills its form shows up in ownyourclick and in your own Google Sheet, with where it came from and a **hot %** that shows how ready they are to buy. Your team then works the leads from the dashboard or straight from the sheet.

### Set it up in five steps

1. **Sign up** at [ownyourclick.com/signup](https://ownyourclick.com/signup), with Google or email. You get **7 days of the Team plan, free, with no card**.
2. **Add your landing page.** Go to **Pages → Add page**, paste the page's address, give it a name and press **Create page**. You get one short link for it.
3. **Add the tag to your page.** On the page's **Settings** tab, copy the tag and paste it into your page's `<head>` (the tab shows where for HTML, WordPress, Webflow, Framer, Next.js and React). See [Tracking code](https://ownyourclick.com/docs#tracking-code).
4. **Connect your Google Sheet.** On the **Configure Sheets** tab, press **Connect Google and create my sheet**. Every lead is written to it from then on. See [Google Sheets](https://ownyourclick.com/docs#sheets).
5. **Send a test lead.** Open your page, fill the form, and watch the **Setup status** checklist tick: "Script detected on your page", "First visit recorded", "First lead received".

Then share the page's link, adding a **source** for each place you post it (Instagram, YouTube, an ad), so every lead shows where it came from.

### The words ownyourclick uses

| Word | What it means |
|---|---|
| **Page** | A landing page of yours that ownyourclick tracks. It has a short link, a dashboard and its leads. |
| **Lead** | Someone who filled the page's form (or was imported, or came in through a lead form). |
| **Source** | Where a visit came from: a version of the page's link for each place you post it, such as Instagram or YouTube. |
| **Hot %** | A score from 0 to 100% for how engaged a lead was on your page compared with your other leads. 70%+ is hot, 40%+ is warm. |
| **Status** | Where a lead is in your process, such as New Lead, Follow Up or Enrolled. You choose the list. |
| **Tag** | A label you put on leads, such as VIP or Callback. A lead can have several. |
| **UTM link** | A short link to any address (your site, a YouTube video), with a version for each place you post it, to count clicks by source. Its leads are the ones its clicks brought, on your landing page or one of your forms. |
| **Click** | One tap on a link. The same person tapping again within 90 seconds is still one click, so double taps and in-app reloads don't inflate it. |
| **Workspace** | Your account's space: its pages, links, leads, sheets and team. Agency has up to 10. |

### Where things are

The left sidebar has **Pages**, **UTM Links**, then under Tools **Create Form** and **WhatsApp**, and under Workspace **White Label**, **Billing** and **Settings**. A page's own screens are tabs at its top: **Dashboard**, **Leads**, **Configure Sheets**, **Automations**, **Payments** and **Settings**.

> Asking an AI assistant? Give it [ownyourclick.com/docs.md](https://ownyourclick.com/docs.md): this whole documentation as one plain-text file.

## Pages: track a landing page

Add a landing page you already have, on any website builder, and get its visits and leads with the source of each.

### Add a page

1. Open **Pages** in the sidebar and press **Add page**.
2. **Page address**: the page people land on, the one with your form (for example `https://yourbrand.com/webinar`).
3. **Name**: what you call it. It also becomes the end of its short link.
4. Press **Create page**. The page opens on its **Settings** tab with "Your link is ready".

Next, add the tag to your page (the same Settings tab, below). Until ownyourclick has seen the tag, the page shows **Code not found** in the list and a yellow dot on its Settings tab.

### The Settings tab

- **Sources.** Your link, with **Copy link**. Add a version of it for each place you post: **+ YouTube**, **+ Instagram**, **+ Facebook**, **+ LinkedIn**, **+ WhatsApp**, **+ Email**, **+ X**, or **+ Other** (type where you're posting it, and a medium if you like, then **Add source**). Each source has its own **Copy**, and up to 30 sources per page. Visits and leads through a source's link are counted under it.
- **Which leads come to this page.** If your site has several pages and you want only some of them here, add address rules (**Add a rule**, **Save rules**).
- **Setup status.** Three checks, re-checked every 10 seconds: "Script detected on your page", "First visit recorded", "First lead received". When all three pass, press **Configure Sheets** to connect your sheet.
- **Add the tag to your landing page**, **Check which forms are captured** and **Test it**: see [Tracking code](https://ownyourclick.com/docs#tracking-code).
- **Pause** stops the page's link from opening the page (nothing is deleted); **Resume** turns it back on. **Delete this page** removes it for good, after you confirm with **Delete permanently**.

### The Dashboard tab

- **How it's going**: Visitors, Visitors → leads, Last lead and Leads a day, for **Today**, **28 days** or **Custom** dates, each compared with a usual day.
- **User behaviour** (from your leads): average time on your page, average scroll, when leads come in, which source brings leads, the devices people use and where they are. **Reset** starts these numbers fresh from now; **Show all time** brings everything back.

If the tag hasn't been seen yet, the dashboard says "Tracking isn't set up on your page yet", with **Set up tracking**.

### The other tabs

- [Leads](https://ownyourclick.com/docs#leads): everyone who filled the form, with statuses, tags, filters, import and export.
- [Configure Sheets](https://ownyourclick.com/docs#sheets): your Google Sheet, its columns, statuses and tags.
- [Automations](https://ownyourclick.com/docs#statuses): lead statuses and WhatsApp messages.
- [Payments](https://ownyourclick.com/docs#payments): payments matched to leads, and Meta ads.

### Find a page

The **Pages** list has a search box and the filters **All**, **Live**, **Paused** and **Needs setup**, with each page's visitors, leads and views → leads for the last 30 days. **Copy link** on a row copies its short link.

## The tracking code

One line on your landing page records visits and picks up your form's leads, with how each person behaved before they filled it.

### Add the tag

Copy the tag from your page's **Settings** tab (it carries your page's id) and paste it into the page's `<head>`:

```html
<script async src="https://go.ownyourclick.com/oyc.js?p=YOUR_PAGE_ID" data-form="form"></script>
```

Where to paste it, by website builder (the Settings tab shows these steps too):

| Builder | Where |
|---|---|
| Plain HTML | Inside `<head>` of the landing page. |
| WordPress | A header-code plugin (or your theme's header settings), on the landing page. |
| Webflow | Page settings → Custom code → Inside `<head>` tag, then publish. |
| Framer | Site or page settings → Custom code → End of `<head>`, then publish. |
| Next.js | `<Script src="…" data-form="form" strategy="afterInteractive" />` from `next/script`, in `app/layout.tsx` or `pages/_app.tsx`. |
| React (Vite, Create React App) | In `index.html` (Vite) or `public/index.html`, inside `<head>`. |

Then open your page and submit a test lead. The **Setup status** checklist on the Settings tab ticks as the tag is seen, a visit is recorded and the lead arrives.

### Which forms are captured

- `data-form="form"` captures every form on the page. To capture only one (say the page also has a newsletter box), give that form an id and point to it: `data-form="#lead-form"`.
- A form is captured when it's submitted and passes its own checks (required fields filled). The same answers sent twice within 5 seconds count once.
- Field names come from the field's name, id, label or placeholder. Passwords and card numbers are never captured.
- Answers that aren't form fields (chips, cards people tap): mark them with `data-oyc-field="Course"` and `data-oyc-value="Data Science"`. Name a form with `data-oyc-label`.

### Leads a form can't hand over

For a multi-step form built in JavaScript, or anything that isn't a plain `<form>`, remove `data-form` from the tag and send the lead yourself, once, when it's complete:

```html
<script>
  oyc('submit', { name: nameValue, email: emailValue, phone: phoneValue });
</script>
```

Other calls:

| Call | What it does |
|---|---|
| `oyc('submit', { … })` | Sends a lead with these fields. |
| `oyc('field', name, value)` | Adds an answer to the lead being filled in. |
| `oyc('payment', 'started' or 'paid', { id, amount, currency })` | Marks a payment against the lead. |
| `oyc('conversion', name)` | Counts a conversion by name. |
| `data-oyc="Book a call"` on any button or link | Counts a click on it as a conversion (on UTM links: lead tracking by "Button click"). |

### What it records, and privacy

For each visit: time actively on the page (not counting a hidden tab or an idle visitor), how far they scrolled, what they clicked, the visit number, the source, and the country, city and device. That's what the [hot %](https://ownyourclick.com/docs#hot-score) is made from. It's first-party: no third-party cookies and no fingerprinting. The click id travels from your link to your page (`?oyc=…`), so each lead is tied to the exact click and source that brought it.

### Set up before 13 September 2026?

Older setups had two pieces of code. Remove both and add the single tag above. The page's Settings tab says so when it sees an old setup.

## UTM Links: a short link for every place you post

Make a short link to any address, add a source for each place you post it, and see which places bring clicks, visits, leads and purchases.

### Make a link

1. Open **UTM Links** and press **New UTM link**.
2. Paste **Your website URL** (your site, a YouTube video, a profile) and press **Create link**. If you already have a link to that address, you're offered **Open it** instead.
3. "Your UTM link is ready" shows your short link, such as `go.ownyourclick.com/your-page`. You can change the part after the `/` until someone first clicks it. Press **Copy link**, **Open dashboard** or **Done**.

That's the **default link**: it opens the address exactly as you pasted it. By default it counts clicks, and opens in the app for YouTube and Instagram addresses (in the phone's browser otherwise).

### Add a source for each place you post

On the link's **Manage links** tab press **+ Add a source**, pick **Instagram**, **YouTube**, **WhatsApp**, **Facebook**, **LinkedIn**, **X / Twitter**, **TikTok**, **Email** or **Other…**, and set its tags: `utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`, and any tag of your own as a key and value (`ref = bio`, `coupon = DIWALI`). Add a **Note for yourself** if you like, then **Add source**. Each source is its own short link.

Each source row has **Stats**, **Edit**, **Pause** / **Resume**, **QR code** (**Download PNG** or **Download SVG**) and **Delete**. **Download clicks (CSV)** exports every click.

Posting somewhere you didn't make a source for? Add `?utm_source=anything` to the link and those clicks show under that name.

### The Dashboard tab

**How it's going** shows clicks (or visits, leads or purchases: pick the goal) for today against a usual day, by source, by hour, device and place. People are counted per day without cookies.

### The Settings tab

- **Campaign name**: rename it.
- **Where it goes**: change the address every source sends to. Each keeps its short link and its numbers.
- **What to track**: **Clicks**, **Visits**, **Leads** or **Purchases**. Visits, leads and purchases need the tracking code on your site (**Install instructions**).
- **Where it opens**, when tapped inside Instagram or Facebook: **As usual**, **In the phone's browser**, or **In the app**.
- **Send leads to**: a webhook address (https) such as Zapier or Make, which gets each lead as it arrives. See [Webhooks](https://ownyourclick.com/docs#webhooks).
- **Lead tracking**: how a lead is counted on your site: **Button click** (the `data-oyc` attribute), **Success / thank-you page**, or **Form submitted**.

Click a link's name at the top of its screen to rename it. A link without a default link offers **Make default link** there.

The list's filters are **All**, **Tracking leads** and **Needs setup**, with each link's clicks, visits, leads and purchases.

## Create Form: a lead form with its own link

No landing page? Make a form at ownyourclick.com/forms/your-form, share the link, and get its leads with statuses and your Google Sheet.

### Make a form

1. Open **Create Form** and press **New form**.
2. Give it a **Form title** and a **Link** (the end of its address), then **Create form**. Its address is `https://ownyourclick.com/forms/your-link`.
3. **Build**: under **Add a field**, add **Name**, **Email**, **Phone**, **Company**, **Short answer**, **Long answer**, **Dropdown**, **Multiple choice**, **Checkboxes**, **Date** or **Number**. Each field can be **Required**, moved up or down, and given placeholder text. Set the **Submit button** label.
4. **After submit**: **Show a thank-you page** (a title, a message and an optional button to your resource) or **Redirect to a URL**.
5. Press **Copy link** and share it, or **Copy embed code** to put the form inside your own website (paste the code where the form should appear). **Open form** shows it as people see it. **Pause** stops it taking answers; **Activate** turns it back on.

### Its leads

- **Analytics**: visits, submissions, visit → lead, traffic sources, devices and browsers for the last 30 days.
- **Leads**: everyone who sent it, with **Search leads…**, **Export CSV** and each lead's details.
- **Track with statuses + Google Sheet** turns the form's leads into a page of their own, with a status for each, a Google Sheet, tags and WhatsApp automations, like a landing page's leads. After that, **Statuses & Google Sheet →** opens it.

Spam is filtered without a captcha.

## Leads: everyone, with their status and tags

A page's Leads tab lists everyone who filled its form, with how they behaved, where they came from, their status and tags.

Open a page, then its **Leads** tab. It starts on **Today**; pick other days at the top.

### Find leads

- **Search name, phone or email**.
- **Sources**: all, **Direct (no link)**, **Untagged**, or one source.
- **Hot %**: **Any hot %**, **Warm and hot (40%+)** or **Hot only (70%+)**.
- **Tags**: any tag, or one.
- **Status pills** with how many are at each status (and **No status**). **Clear filters** resets them. Filters are remembered for this page in this browser.

The list shows 100 at a time (**Show N more**), up to the newest 1,000 for the days picked.

### Columns

Press **Columns** and tick what to show: contact fields; Status, Tags, Hot %, Payment, Arrived; Time on page, Scroll, Clicks, Visit #; Source, First source, UTM campaign, medium, content and term, Page; Country, State / region, City, Device; and your form's own fields. **Reset** goes back to the default.

### One lead in full

Open a row and a panel opens on the right, where you can add notes that stay on the lead's timeline. It shows what they submitted, and before they submitted: where they came from (and where they first came from), which visit it was, time on the page, how far they scrolled, what they clicked, place, device, the page, and whether it reached your Google Sheet. Below that is the lead's timeline: statuses, messages and payments.

### Change a status

Click the lead's status chip and pick one, on any page. With **lead statuses** switched on for the page, a status you set here is also written to your sheet and can start a WhatsApp automation. The list of statuses is yours: see [Statuses](https://ownyourclick.com/docs#statuses).

You can also change statuses from your Google Sheet (see [Google Sheets](https://ownyourclick.com/docs#sheets)) or from another app with the [API](https://ownyourclick.com/docs#api-status).

### Tag a lead

In the lead's **Tags** cell press **+ Tag**, find a tag or make a new one (**+ Make "…"**), and tick it. Tags are shared with every sheet of the page. The page's tag list is edited in **Configure Sheets → Tags** (up to 50).

### Import and export

- **Import leads**: **Choose CSV file**, then match each column of your file to where it goes (**Leave out** skips one). Imported leads never get a WhatsApp message by themselves.
- **Export CSV**: downloads the leads the current filters show.

## The hot %: who's ready to buy

Every lead gets a score from 0 to 100% for how engaged they were on your page, compared with your page's other leads.

### What it's made of

- **Time actively on your page**, across all their visits since their last lead (a hidden tab or an idle visitor doesn't count).
- **How far they scrolled.**
- **How many things they clicked.**
- Optionally, **how many times they came back**.

### How it's worked out

Each of these is compared with your page's best leads: the 95th percentile of the newest 2,000 leads (so one outlier doesn't set the bar), or the highest so far while the page has fewer than 20 leads. Each measure counts up to 100%, and the hot % is their average. Imported leads aren't used to set the bar.

So a lead at 80% engaged about as much as your most engaged leads; one at 15% barely looked. **70% and up is hot** (red), **40% and up is warm** (yellow).

### Where you see it

On the Leads tab (filter **Hot only (70%+)**), in your Google Sheet's **HOT %** column, in webhooks (`hot_pct`) and in the API. The sheet and webhooks get the score from when the lead arrived; the dashboard keeps it up to date as more leads come in.

Call the hot ones first: they're the people who read your page.

## Google Sheets as your CRM

Every lead goes into your own Google Sheet as it arrives. Your team works the leads from the sheet, and their changes come back.

### Connect a sheet

On a page's **Configure Sheets** tab, press **Connect Google and create my sheet** (or **Create my sheet** if Google is already connected). ownyourclick makes a new sheet in your Google Drive and writes every lead to it. It can only open the sheets it creates for you, never your other files.

**Prefer your own sheet?** Press **Show steps** and use a script instead:

1. Open your Google Sheet, then **Extensions → Apps Script**.
2. Replace everything there with the script (**Copy script**).
3. **Deploy → New deployment → Web app**, with Execute as **Me** and Who has access **Anyone**.
4. Paste the **Web app URL** and press **Connect**.

A script sheet gets every lead, but changes made in it don't come back to ownyourclick. Use the connected Google sheet for two-way work.

### What's in the sheet

- **Leads**: one row per lead, with the columns you choose.
- **Dashboard** and **Selected Leads** tabs.

Choose columns under **Your sheet**: contact (Date, Time, Name, Email, Phone); how engaged they were (HOT %, Buttons clicked, Scroll %, Time spent, Clicks, Visit #); Payment; where they came from (Source, First source, UTM campaign, medium, content, term, Came by, Referrer, Page); where they are (Country, City, Device); your form's fields; and your links' own tags. **Status** and **Notes** always come last. A column you turn off is hidden, never deleted. Press **Save** (or **Undo changes**).

### Statuses and tags in the sheet

- **Statuses**: under **Your sheet → Statuses**, click one to rename it or change its colour, drag to reorder, **+ Add status** (up to 20), or **Remove** (its leads move to a status you pick). The first status is the one new leads get. The defaults are New Lead, Not Interested, Follow Up and Enrolled. Saving statuses here also turns lead statuses on for the page.
- **Tags**: under **Tags**, the same way (up to 50), then **Save tags**. In the sheet, type tags into a lead's Tags cell, separated by commas; a new name becomes a tag.

### Two-way: your team works from the sheet

With a connected Google sheet, what your team changes in **Status**, **Tags**, follow-up and **Notes** comes back to ownyourclick within about 30 seconds. A status changed in the sheet moves the lead, shows on its timeline and starts any WhatsApp automation waiting for it. And everything that changes in ownyourclick (new leads, statuses, payments, tags, scores) is written to the sheet.

### More than one sheet

Press **+ Add sheet** to send the same leads to another sheet (up to 5 more per page), for another team or a partner. Name it, choose whether to **Copy the leads you already have**, and **Create sheet**. Each extra sheet has its own columns and its own statuses; its statuses stay in that sheet and don't change the lead's main status. **Stop sending to this sheet** ends it.

### When something's wrong

The tab shows how the sheet is doing: "Working · last lead …", or how many leads didn't reach it.

- **Resend N** sends the leads that didn't get there.
- **Re-sync** rewrites the sheet from ownyourclick's records (columns, statuses, rows).
- **More → Send a test lead**, **Copy existing leads**, **Disconnect**.
- If your sheet runs an older copy of the script, the tab says so: copy the new script and redeploy.

Leads aren't sent to the sheet while the workspace has no plan. After you pick a plan, press **Resend**.

## Lead statuses and automations

Turn on statuses for a page to move leads through your process, by hand, from the sheet, from payments, or from your own tools.

### Turn statuses on

On a page's **Automations** tab, switch on **Lead statuses** and press **Save**. (Saving a status list in **Configure Sheets → Your sheet → Statuses** turns them on too.) The list itself is edited in Configure Sheets: see [Google Sheets](https://ownyourclick.com/docs#sheets).

### Move leads automatically

On the same card:

- "When your payment gateway confirms a payment of [amount], move the lead to [status]".
- "When a payment is refunded, stop its messages and move the lead to [status]".
- "When they submit a form from their own WhatsApp link, move the lead to [status]".

### Every way a status changes

| From | How |
|---|---|
| The Leads tab | Click the lead's status chip. |
| Your Google Sheet | Change the Status cell (connected Google sheets). |
| A payment | The rules above, with your gateway connected ([Payments](https://ownyourclick.com/docs#payments)). |
| A WhatsApp button | "When they tap a button → move to [status]" in an automation ([WhatsApp](https://ownyourclick.com/docs#whatsapp)). |
| Your own app or Zapier | `POST /api/v1/leads/status` ([API](https://ownyourclick.com/docs#api-status)). |

Every change is on the lead's timeline, saying who or what made it, is written to the sheet, and can start a WhatsApp automation.

## Payments, matched to the lead who paid

See which leads paid, and how much, from your thank-you page or straight from Dodo Payments, Razorpay or Stripe.

Open a page, then its **Payments** tab.

### From the page people see after paying

Under **The page people see after paying**, enter the **Address of that page** (for example `/thank-you`, or `status=succeeded` if the address carries it), and the price if the address doesn't carry it. If the address holds the payment id or the amount, say which setting does. **Save**. A lead who reaches that page is marked as paid. Words like "failed" in the address's status don't count.

### From your payment gateway (most reliable)

Under **Your payment gateway**, pick **Dodo Payments**, **Razorpay** or **Stripe** and the currency.

1. Copy the webhook address shown and add it in your gateway's webhook settings, for the payment-succeeded and refunded events.
2. Paste the **Signing secret from your gateway** and press **Save secret**.

Razorpay works a little differently. It has no secret to copy: on **Accounts & Settings → Webhooks → Add New Webhook** you type a long secret of your own in the **Secret** box, then paste the same one here as the **Webhook secret**. Your Razorpay Key ID and Key Secret aren't used.

**Once for every page.** Most programs sell through the same gateway, so after the secret is saved, tick **Use this gateway for every page**. Every page in your workspace, new ones included, then reports payments through that one address and secret: nothing to paste into the gateway again. A page can still have a gateway of its own: paste a secret on that page and it uses that instead.

Each payment is then matched to its lead: by the ids ownyourclick passes along, by the visitor or click, or by email or phone. With a gateway connected, the thank-you page only marks "Payment started", and the gateway confirms. Someone leaving for a checkout page (Razorpay, Stripe, Dodo, Cashfree, PayU, Instamojo, PhonePe, Paytm, PayPal and others) is marked "Payment started" too.

### Meta ads

The Meta pixel has its own tab, **Meta ads**. Add your **Pixel ID** and choose which events to send (**Page view**, **Lead**, **Purchase**, **Initiate checkout**). Initiate checkout goes from the browser when someone leaves your page for a checkout page, once per visit. If the page already runs the same pixel, leave it there: the tag uses it and doesn't start a second copy, but if your own code also sends Lead or Purchase, turn those off here so they don't count twice. Add a **Conversions API access token** to send them from the server as well. To check it, save the code from Events Manager → Test events and press **Send test event**, then remove the code. If your form has a qualifying question, tick **Send Lead only for certain answers**, pick the question and the answers that count: every lead is still saved, but only people who gave one of those answers are sent to Meta as a Lead (the list of questions comes from your leads, so send one test lead first). Under **When a lead's status changes, tell Meta**, pick statuses that send **Purchase**, **Qualified lead**, **Schedule** or **Contact**, so Meta learns which leads were good. Pick what your Meta campaign is optimised for (**Leads**, **Purchases** or **Landing page views**) and a period (**Today**, **28 days** or **Custom**): the tab compares what ownyourclick recorded from your Meta ads, what it sent to Meta, and what Meta accepted, says why any are missing, lists every event sent, and gives the usual reasons Meta's count differs from yours.

#### Custom events for retargeting

Under **Custom events for retargeting**, press **+ New event**, give it any name (letters, numbers and _, like `SOLVED_Engaged_2min`) and pick when it fires: **Time on page** (seconds with the page open), **Scroll** (% of the page), **Visits** (their 2nd, 3rd… visit), **Clicks** (how many), or **Clicked text** (they clicked something that says, for example, "Register"). Add up to 6 conditions; it fires when all are true, once per visit, through your pixel. Under **Advanced settings** you can also require where the visit came from, read from the page address it started on: **Source** (utm_source), **Medium** (utm_medium) or **Page address has** any parameter (like `fbclid`, with or without a value), or a **Form answer** (it fires when they send the form with that answer). Each matches with **is**, **is not** or **contains**, and takes several values separated by commas. Only the event's name goes to Meta, never the answer, and Meta's rules forbid naming events after health, money troubles or other sensitive details. Up to 10 events per page. Meta's own names (Lead, Purchase and the rest) can't be used.

There's nothing to create in Meta first: the event appears under your pixel once it has fired. To retarget, open **Audiences → Create audience → Custom audience → Website**, pick your pixel and your event, and **Exclude** people who did **Lead** to reach those who were interested but didn't fill the form. The audience fills from the day the event starts firing, and Meta needs about 100 people before it shows ads to it. Each event's row shows how often it fired in the period you picked.

The **Payments log** lists every payment: when, what, who, and which gateway told us.

## WhatsApp messages, automations and campaigns

Message leads on WhatsApp when they arrive or reach a status, and send campaigns to pages, contact lists and form leads. In beta.

### Connect WhatsApp

WhatsApp is sent through the WhatsApp Business API, with **Askeva** or **Gallabox**. In **Settings → WhatsApp**, pick your provider, add its API key and press **Connect** (it's checked with the provider first, then stored hidden). Copy the webhook address shown into your provider, so replies and delivery updates come back. Until WhatsApp is connected, nothing can be sent.

### Automations: a message when a lead reaches a status

On a page's **Automations** tab, under **WhatsApp automations**, press **Add an automation**:

- **When a lead enters** [a status], **wait** [minutes, hours or days; 0 = straight away], **then send** [a template or text].
- **When they tap a button → move to** [a status], with an optional reply.
- **When it's sent, move the lead to** [a status].
- If it can't be sent or delivered, it tries again after 5 minutes, 30 minutes and 2 hours, then can move the lead to a status.
- A reminder if they don't reply within a time you set.

Press **Save automations**. Messages sent straight away go at any hour; delayed ones go between 9am and 9pm India time. Anyone who replies STOP gets nothing more. Nothing is sent until you switch an automation on.

### Contact lists

Under **WhatsApp → Contact lists**, give a **List name** and press **Make list and upload a sheet** to bring in people you already have. A list works like a page: People, statuses and a sheet.

### Campaigns

Press **New campaign**:

- **Who gets it**: a page's leads, a contact list or form leads, at the statuses you pick. You see how many it reaches before sending.
- **Everyone it reaches** or **At most N**, and whether to keep going for people who arrive later.
- **What it sends**: a template or text, with buttons. **Send to me** sends a test to your own number.
- **Sending**: steadily at most N a day, or in batches.
- **Save and send to the first 5** to check it, then **Send to the remaining N**. You can **Stop**, **Duplicate** or **Edit** a campaign, and **Show people** to see who got it.

## Let Claude or ChatGPT write your emails

Ask Claude or ChatGPT to write your status emails and sequences, then paste them into ownyourclick in one go. Saved switched off for you to check.

Claude and ChatGPT are good at writing follow-up emails. ownyourclick takes what they write in one paste: every status email and sequence, with its statuses, waits and stop rules.

### The quick way

1. Open a page, then **Automations → Email**.
2. In the side card **Let AI write your emails**, press **Claude** or **ChatGPT**. It opens with a prompt that already lists your page's statuses and points at these docs.
3. Tell it about your business and what each email should do. It asks questions, then writes the emails and ends with one block of text starting with `{`.
4. Copy that whole block. Back in ownyourclick, press **Paste from Claude / ChatGPT**, paste it and press **Add**.
5. Everything is added **switched off**. Open each one, check the words and the phone preview, press **Send me a test**, then switch it on.

Nothing is sent until you switch it on. You don't need to share an API key for this.

### What to ask for

- "A welcome email when a lead reaches New Lead, straight away."
- "A 4-email sequence for Event Interested: day 0, day 1, day 3, day 5. Stop if they reach Enrolled for Event. End on 19 December. If it runs out, move them to No response."
- "Make the confirmation a designed email with a details box (When, Time, Where) and a Join button."

### The format it writes

```json
{
  "statusEmails": [
    {
      "name": "Welcome",
      "status": "New Lead",
      "delayMinutes": 0,
      "subject": "Thanks, {first_name|there}",
      "body": "Hi {first_name|there},\n\nThanks for your interest...",
      "onSent": ""
    }
  ],
  "sequences": [
    {
      "name": "Event follow-up",
      "status": "Event Interested",
      "schedule": { "days": "daily", "minute": 600 },
      "onlyWhileStill": true,
      "goalStatuses": ["Enrolled for Event"],
      "endDate": "2026-12-19",
      "maxDays": null,
      "onEnd": "No response",
      "steps": [
        { "waitMinutes": 0, "subject": "Your seat is waiting", "body": "Hi {first_name|there}, ..." },
        { "waitMinutes": 1440, "onSchedule": true, "subject": "Only a few seats left", "body": "..." }
      ]
    }
  ]
}
```

- **status, onSent, goalStatuses, onEnd:** a status on the page, by its name as it shows in ownyourclick (or its id).
- **delayMinutes / waitMinutes:** 0 is straight away; 60 an hour; 1440 a day. Waits in whole days go out at your send time (Email → Settings).
- **schedule:** the days a sequence's emails go out: "days" is "daily", "alternate" (every other day) or "weekly" (with "weekday": 0 Sunday … 6 Saturday), and "minute" is the time of day (600 is 10:00 AM). A step with "onSchedule": true follows it; a step's own "minute" overrides the time.
- **Fields:** {first_name|there}, {name}, {email}, {phone}, {page}, or any question on your form by its name, like {city}. In "body", a blank line starts a new paragraph. **bold** and _italic_ work in the text.
- **A designed email** uses "blocks" instead of "body": `{ "type": "heading", "text": "You're in.", "size": "lg" }`, `{ "type": "text", "text": "..." }`, `{ "type": "details", "rows": [{ "label": "When", "value": "Sat 10 AM" }] }`, `{ "type": "steps", "items": [{ "title": "...", "text": "..." }] }`, `{ "type": "button", "label": "Join", "url": "https://..." }`, `{ "type": "divider" }`.
- **Pictures** aren't part of the plan. Add one yourself in the editor (Designed email → Picture): one per email, PNG, JPG or GIF up to 2 MB.

### If Claude is connected to ownyourclick

With the [AI connection](https://ownyourclick.com/docs#mcp) set up and **Let it make changes** ticked, you don't need to paste. Ask Claude "Write the follow-up emails for my webinar page". It reads the page's statuses, writes the emails with you, and adds them switched off.

### Using the API instead

If you use a tool that can make web requests (Claude Code, an agent, Zapier or Make), it can add the same plan with your API key: see [Email API](https://ownyourclick.com/docs#api-email). In a normal Claude or ChatGPT chat, paste instead: they can't send requests themselves, and an API key pasted into a chat stays in its history.

## White label: links on your own domain

Put your links on a subdomain of yours, such as link.yourbrand.com, instead of go.ownyourclick.com. (On Team and Agency.)

1. Open **White Label** and enter **Your subdomain**, such as `link.yourbrand.com` (a subdomain, not the bare `yourbrand.com`). Press **Connect domain**.
2. Add the records shown at your DNS provider (Cloudflare, GoDaddy, Namecheap…). Each has a **Copy** button.
3. Press **Check status** until it's live. The SSL certificate is handled for you.

The records:

- **Traffic**: a **CNAME** from your subdomain to `cname.ownyourclick.com`.
- **Ownership verification**: the record shown.
- **Certificate**: set once; it renews by itself.

Your links and the tracking code then use your domain. **Remove** takes it off.

## Your team

Invite any number of people to work the workspace's leads, pages and links. (On Team and Agency.)

In **Settings → Team**, press **+ Invite**, enter their **Email address** and **Send invite**. They get an email to join. Pending invites show as **Pending**, and you can revoke them; remove a member with ✕.

Members see and work everything in the workspace: pages, leads, statuses, sheets, links and WhatsApp. The workspace owner alone creates [API keys](https://ownyourclick.com/docs#api) and manages billing.

The 7-day trial includes Team, so you can try it with your team before picking a plan.

## Workspaces, for several brands or clients

Keep each brand or client apart, with its own pages, leads, sheets and team, all on one bill. (On Agency.)

The workspace switcher is at the bottom of the sidebar. On Agency, open it and press **New workspace**, give it a **Workspace name** and press **Make it**. You can have up to 10, and the switcher shows how many you have.

Each workspace has everything in Team: its own pages, links, leads, Google Sheets, team and WhatsApp, and they're kept apart. One Agency plan pays for all of them.

Rename a workspace in **Settings → Workspace**.

## Plans and billing

Every account starts with 7 days of Team, free, with no card. Then pick Solo, Team or Agency, monthly or yearly.

### The plans

| Plan | Monthly | Yearly | For |
|---|---|---|---|
| **Solo** | ₹699 · $9 | ₹6,990 · $90 | One person who works the leads. Everything except team, white label and the API. |
| **Team** | ₹1,299 · $17 | ₹12,990 · $170 | More than one person working the leads. Adds any number of teammates, white label and the API. |
| **Agency** | ₹3,999 · $49 | ₹39,990 · $490 | Several brands or clients. Everything in Team, in up to 10 workspaces, on one bill. |

Yearly costs ten months, so two months are free. Rupee prices are in India (with UPI at checkout); dollar prices everywhere else. Every plan has unlimited pages, links and leads, the hot %, Google Sheets, WhatsApp, payments, contact lists and CSV export. Not sure which? See [which plan fits you](https://ownyourclick.com/pricing).

### Pick or change a plan

Open **Billing**, choose **Monthly** or **Yearly** and dollars or rupees, then **Choose** a plan (or **Switch to** another). Payments are handled by our merchant of record and renew until you cancel. **Invoices and card** shows your invoices and the card you pay with. **Cancel plan** stops it renewing.

### When the trial or a plan ends

The dashboard closes until you pick a plan; only Billing stays open. Your links keep working, your pages keep recording leads, and nothing is deleted. Leads aren't sent to your Google Sheet in the meantime: after you pick a plan, press **Resend** on Configure Sheets.

### Earlier Pro plan

Customers on the earlier Pro plan keep it, at their price, for as long as they stay subscribed. If it ends, it can't be bought again. See the [refund policy](https://ownyourclick.com/refunds).

## Connect Claude, ChatGPT or a coding tool

Ask an AI about your leads and numbers, update them, and let it connect the pages you build. (On Team and Agency.)

MCP is the standard way to connect a product to an AI assistant. Once connected, you ask in plain words and the AI works with your ownyourclick workspace for you.

**You need:** the Team or Agency plan (the free trial is Team, so it works during your trial), and to be the workspace's owner. Each connection is for one workspace. If the plan ends, the connection stops working straight away, and comes back when you pick Team or Agency again.

The address, for every app:

```
https://app.ownyourclick.com/mcp
```

### Connect Claude

1. In Claude, open **Settings → Connectors** and choose **Add custom connector**.
2. Give it a name, such as ownyourclick, and paste the address above.
3. Choose **Connect**. A window opens: sign in to ownyourclick.
4. Choose the workspace and what the AI may do, then press **Allow**.

Then, in a chat, make sure the connector is switched on, and ask it something.

### Connect ChatGPT

1. In ChatGPT, open **Settings → Apps & Connectors → Advanced settings** and switch on **Developer mode**. It needs a paid ChatGPT plan, and on a business account your admin may have to allow it.
2. Back in **Apps & Connectors**, choose **Create**, name it, paste the address above and choose OAuth.
3. Sign in to ownyourclick, choose the workspace and what the AI may do, then press **Allow**.
4. In a chat, open the **+** menu, choose **Developer mode**, and pick ownyourclick.

These apps move their menus around. If a name is different, look for "custom connector" or "MCP".

### What the approve screen asks

- **The workspace** this connection is for.
- **Let it make changes.** Off, it can only read. On, it can create pages, change a lead's status and tags, add notes, delete leads when you ask, and connect Meta and payments.
- **Share phone numbers and emails.** Off, they're hidden from the AI. On, your leads' contact details go to the AI company.

To change either later, disconnect and connect again.

### Connect a coding tool

Coding tools can sign in the same way, or use an API key. Create one in **Settings → API**.

In Claude Code:

```
claude mcp add --transport http ownyourclick https://app.ownyourclick.com/mcp --header "Authorization: Bearer YOUR_API_KEY"
```

In Cursor, add this to `.cursor/mcp.json`:

```
{
  "mcpServers": {
    "ownyourclick": {
      "url": "https://app.ownyourclick.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

A key can read everything and make changes, including phones and emails. Keep it out of code you share.

### Connect a page you're building

Say this to your coding tool: "Track this site with ownyourclick." It creates the page, adds the tracking tag inside your site's `<head>`, and after you publish, checks that the code is live on the right site.

### Things to ask

- "Which source brought the most leads on my webinar page this month?"
- "Which ad brought paying customers in the last 7 days?"
- "Show my hottest leads from today that haven't paid."
- "What did Priya do before she filled in the form?"
- "Move Arun to Interested and add a note that I called him."
- "Is Meta receiving my leads? Were any refused?"
- "Connect Razorpay to my course page and give me the webhook address."
- "Write the follow-up emails for my webinar page."
- "Delete the test leads from today." It lists them and asks you to confirm first.

### What it can do

- **Pages:** list them, create one and get its tag, check the code is live, make a link for each source, rename or pause.
- **Leads:** find them by words, source, status, tag, hot % or payment; see one in full; change status and tags; add notes; delete.
- **Meta:** save the Pixel ID, access token and test code, send a test event, and see what Meta received or refused.
- **Payments:** connect Razorpay, Stripe or Dodo, and see payments matched to leads.
- **Reports:** a page's numbers, and which source, campaign or ad brings paying customers.
- **Links and forms:** list and create UTM links, and read form submissions.
- **Emails:** see a page's statuses and emails, and add status emails and sequences it writes with you. They're saved switched off for you to check.

### What it can't do

It can't send WhatsApp messages, delete pages, connect a Google Sheet or change your billing. A status it sets updates ownyourclick and your Google Sheet, but starts no WhatsApp automation and sends Meta nothing. Deleting leads always takes a second confirmation.

Anything you type in a chat also passes through the AI service. For a Meta token or a payment signing secret, the page's own **Meta ads** and **Payments** tabs are the safer place.

### See what it did, or disconnect

**Settings → Connect your AI** lists what's connected and its recent activity, with a **Disconnect** button. Changes it makes also show on the lead's timeline with the app's name.

### If something doesn't work

- **"Part of the Team and Agency plans":** this workspace isn't on one. Choose a plan in Billing.
- **"This connection can only read":** disconnect, connect again, and tick **Let it make changes**.
- **"This page doesn't track statuses":** switch on Lead statuses in the page's Automations tab.
- **"Too many requests":** the limit is 60 actions a minute for each workspace. Wait a minute.
- **Asked to sign in again:** the connection lapsed after 90 days. Sign in, and it carries on.

## The API: get started

Read your leads, links and forms, and change leads' statuses and tags, from your own app, a script, Zapier or Make. (On Team and Agency.)

### Create a key

In **Settings → API**, enter a **Key name** (say, the app it's for) and press **Create key**. The full key is shown once: press **Copy key**, store it somewhere safe, then **I've saved it**. Only the workspace owner can create keys. **Revoke** stops a key at once; the list shows when each key was last used.

### Make a call

Every call goes to `https://app.ownyourclick.com/api/v1` with your key as a Bearer token:

```bash
curl https://app.ownyourclick.com/api/v1/workspace \
  -H "Authorization: Bearer oyc_YOUR_KEY"
```

```json
{ "workspace": { "id": "…", "name": "My workspace", "plan": "team", "lifetime_clicks": 1520 } }
```

- Answers are JSON. Send JSON bodies with `Content-Type: application/json`.
- `from` and `to` (on the calls that take them) are a date such as `2026-10-01`, a full time such as `2026-10-01T09:30:00Z`, or epoch milliseconds. Left out, they're the last 30 days. A plain date is that whole day in India time: `from=2026-10-01&to=2026-10-01` is 1 October from midnight to 23:59:59 IST. Add `tz` for another time zone, such as `&tz=Asia/Dubai`. Daily timelines use the same days.
- Lists come newest first, up to 1,000.
- An error has an `error` code and, usually, a `hint` saying what to send. `401`: the key is missing, wrong or revoked.

### Every endpoint

| Call | What it does |
|---|---|
| `GET /workspace` | Your workspace: id, name, plan. |
| `GET /pages` | Your pages (and form-lead pages, contact lists), and whether each tracks statuses. |
| `GET /pages/:id/leads` | A page's leads with status, tags and hot %. [Read leads](https://ownyourclick.com/docs#api-leads) |
| `GET /leads` | Every lead in the workspace, with how they behaved. [Read leads](https://ownyourclick.com/docs#api-leads) |
| `GET /pages/:id/statuses` | The statuses a page's leads can have. [Change a status](https://ownyourclick.com/docs#api-status) |
| `GET /pages/:id/email` | A page's status emails and sequences. [Emails](https://ownyourclick.com/docs#api-email) |
| `POST /pages/:id/email/import` | Add status emails and sequences, switched off. [Emails](https://ownyourclick.com/docs#api-email) |
| `POST /leads/status` | Move a lead to a status. [Change a status](https://ownyourclick.com/docs#api-status) |
| `GET /pages/:id/tags` | The tags a page's leads can have. [Tags](https://ownyourclick.com/docs#api-tags) |
| `POST /leads/tags` | Add, remove or set a lead's tags. [Tags](https://ownyourclick.com/docs#api-tags) |
| `GET /links` | Every page, UTM link and form link, with clicks, leads and conversions. [Links](https://ownyourclick.com/docs#api-links) |
| `GET /links/:id/stats` | One link's clicks, people, leads and conversions, day by day. |
| `GET /links/:id/engagement` | Time on page and clicks, visit by visit. |
| `GET /links/:id/leads` | One link's leads. |
| `GET /visits` | Visits, visitors, return visits. |
| `GET /forms` | Your lead forms, with visits and submissions. |
| `GET /forms/:id/submissions` | What people sent through a form. |

> Treat a key like a password: it can read your workspace's leads and change their statuses and tags. Keep it on a server or in your automation tool, never in a web page.

## API: read your leads

Pull a page's leads with their status, tags and hot %, or every lead in the workspace with how they behaved before they enquired. (On Team and Agency.)

### A page's leads, as its Leads tab shows them

First find the page's id:

```bash
curl https://app.ownyourclick.com/api/v1/pages -H "Authorization: Bearer oyc_YOUR_KEY"
```

```json
{ "pages": [ { "id": "lp_8k2f9", "name": "Webinar", "url": "https://yourbrand.com/webinar", "status": "active", "tracksStatuses": true } ] }
```

Then its leads, this month, warm and hot only:

```bash
curl "https://app.ownyourclick.com/api/v1/pages/lp_8k2f9/leads?from=2026-10-01&min_hot=40" \
  -H "Authorization: Bearer oyc_YOUR_KEY"
```

```json
{
  "from": 1790812800000, "to": 1792152000000,
  "page": { "id": "lp_8k2f9", "name": "Webinar", "tracksStatuses": true },
  "count": 1,
  "leads": [
    {
      "id": "ld_3f1c…",
      "at": 1792060000000,
      "data": { "name": "Priya", "email": "priya@example.com", "phone": "+91 98765 43210" },
      "status": "Follow Up",
      "tags": ["VIP"],
      "hot_pct": 82,
      "source": "Instagram",
      "first_source": "YouTube",
      "visit_number": 2,
      "engaged_seconds": 214,
      "scroll_pct": 90,
      "clicks": 6,
      "payment": null,
      "page_url": "https://yourbrand.com/webinar",
      "place": { "device": "mobile", "country": "IN", "region": "Tamil Nadu", "city": "Chennai" },
      "utm": { "campaign": "diwali", "medium": "social", "content": "", "term": "" }
    }
  ]
}
```

Settings: `from`, `to`, `min_hot` (0 to 100) and `source` (a source's key).

### Every lead in the workspace

`GET /leads` returns every page's leads (add `campaign_id` for one page), with how they behaved around the moment they enquired: time engaged before and after, clicks before and after, the visit number, the session's start and end, and webhook delivery. Each has `data` (what they submitted), `tracking` (source, UTMs, device, place, the hot % when they arrived) and `payment`.

```bash
curl "https://app.ownyourclick.com/api/v1/leads?from=2026-10-01" -H "Authorization: Bearer oyc_YOUR_KEY"
```

Use `/pages/:id/leads` when you need statuses and tags; `/leads` when you need everything at once.

### Keep another app in step

Ask every few minutes for leads since the last time you asked (`from` = the newest `at` you've seen), and use each lead's `id` to skip ones you have. Or get each lead the moment it arrives with a [webhook](https://ownyourclick.com/docs#webhooks).

## API: change a lead's status

Move a lead to a status from another app: a booking tool marking Meeting Booked, a payment system marking Paid, or your own CRM. (On Team and Agency.)

A status set through the API works exactly like one set by hand: it's written to the Google Sheet, shows on the lead's timeline (as your key's name), and starts any WhatsApp automation waiting for that status.

### Before you start

- The page must track statuses: turn on **Lead statuses** on its **Automations** tab. Otherwise you'll get `409 statuses_off`.
- See the statuses the page has:

```bash
curl https://app.ownyourclick.com/api/v1/pages/lp_8k2f9/statuses -H "Authorization: Bearer oyc_YOUR_KEY"
```

```json
{
  "page": { "id": "lp_8k2f9", "name": "Webinar" },
  "tracksStatuses": true,
  "statuses": [ { "id": "new", "label": "New Lead" }, { "id": "follow", "label": "Follow Up" }, { "id": "meet", "label": "Meeting Booked" } ]
}
```

### Move a lead

`POST /leads/status` with the status (its label in any case, or its id) and the lead: by its `lead_id`, or by the `email` or `phone` it submitted. A status the page doesn't have yet is added to its list the first time it's sent, so another CRM can keep its own statuses.

```bash
curl -X POST https://app.ownyourclick.com/api/v1/leads/status \
  -H "Authorization: Bearer oyc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "priya@example.com", "status": "Meeting Booked" }'
```

```json
{
  "ok": true,
  "lead_id": "ld_3f1c…",
  "page": { "id": "lp_8k2f9", "name": "Webinar" },
  "status": "Meeting Booked",
  "previous": "Follow Up",
  "changed": true,
  "created": false,
  "also": ["ld_29ab…"]
}
```

| Field | Send |
|---|---|
| `status` | Required. A status label ("Meeting Booked", any case) or its id ("meet"). A new label is added to the page's statuses. |
| `lead_id` | The lead's id (from the API or a webhook). Or instead: |
| `email` | The email the lead submitted. The most recent matching lead is moved. |
| `phone` | The phone the lead submitted, written any way (`98765 43210`, `+91 9876543210`). |
| `page_id` | Optional: only look on this page. Needed to find a form's leads by email or phone. |

- By email or phone, the latest lead on a page that tracks statuses is moved, and the same person's other leads on that page (someone who filled the form twice) move with it, listed in `also`.
- `changed` is `false` when the lead was already at that status: nothing happens, and it's safe to send again.
- `created` is `true` when the status was new and was added to the page's list (and its sheet's dropdown). A page holds up to 20 statuses.

### Errors

| Code | Means | Fix |
|---|---|---|
| `400 status_required` | No status sent. | Send `status`. |
| `400 lead_required` | No lead sent. | Send `lead_id`, `email` or `phone`. |
| `409 status_limit` | A new status, but the page already has 20. | Remove one you don't use under the page's statuses, or send one of the labels listed in `statuses`. |
| `404 lead_not_found` | No lead matches. | Check the email or phone, or send `page_id`. |
| `409 statuses_off` | The lead exists, but its page doesn't track statuses. | Turn on Lead statuses on its Automations tab. |

### From your own code

JavaScript (Node.js or any server):

```js
await fetch("https://app.ownyourclick.com/api/v1/leads/status", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.OYC_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ phone: "+91 98765 43210", status: "Paid" }),
});
```

Python:

```python
import os, requests
requests.post(
    "https://app.ownyourclick.com/api/v1/leads/status",
    headers={"Authorization": f"Bearer {os.environ['OYC_KEY']}"},
    json={"email": "priya@example.com", "status": "Enrolled"},
)
```

### From Zapier, Make or n8n (no code)

Add a step that makes a web request (Zapier: **Webhooks by Zapier → Custom Request**; Make: **HTTP → Make a request**; n8n: **HTTP Request**):

- Method **POST**, URL `https://app.ownyourclick.com/api/v1/leads/status`.
- Header `Authorization`: `Bearer oyc_YOUR_KEY`. Header `Content-Type`: `application/json`.
- Body: `{"email": "<the email from the earlier step>", "status": "Meeting Booked"}`.

For example: when Calendly books a call, move that email's lead to Meeting Booked; when an invoice is paid, move it to Paid.

## API: tag leads

Add or remove a lead's tags from another app. Tags don't need statuses switched on. (On Team and Agency.)

### See a page's tags

```bash
curl https://app.ownyourclick.com/api/v1/pages/lp_8k2f9/tags -H "Authorization: Bearer oyc_YOUR_KEY"
```

```json
{ "page": { "id": "lp_8k2f9", "name": "Webinar" }, "tags": [ { "id": "t1", "label": "VIP" }, { "id": "t2", "label": "Callback" } ] }
```

New tags are made in the dashboard (**Configure Sheets → Tags**, or **+ Tag** on a lead), not through the API.

### Add, remove or set tags

```bash
curl -X POST https://app.ownyourclick.com/api/v1/leads/tags \
  -H "Authorization: Bearer oyc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "priya@example.com", "add": ["VIP"], "remove": ["Callback"] }'
```

```json
{ "ok": true, "lead_id": "ld_3f1c…", "page": { "id": "lp_8k2f9", "name": "Webinar" }, "tags": ["VIP"], "previous": ["Callback"] }
```

| Field | Send |
|---|---|
| `add` | Tags to add: labels (any case) or ids. |
| `remove` | Tags to take off. |
| `set` | Instead of add and remove: the lead's whole list (`[]` clears it). |
| `lead_id`, `email` or `phone` | The lead, as for statuses. By email or phone, the most recent matching lead. |
| `page_id` | Optional: only look on this page. |

Tags reach the page's Google Sheet straight away. Errors: `400 tags_required`, `400 lead_required`, `400 unknown_tag` (the answer lists the page's tags), `404 lead_not_found`.

## API: links, visits and forms

Clicks, people and conversions for every link, visit figures, and your lead forms' submissions. (On Team and Agency.)

### Links

`GET /links` lists every page, UTM link and form link, with its `kind`, `status`, address, and lifetime `clicks`, `leads` and `conversions`.

- `leads`: the leads you see in the app: form fills on a page, or, for a UTM link, its clicks that became a lead.
- `conversions`: events from the conversion tag on a thank-you or purchase page (see Settings → Conversion snippet). Zero if you don't use that tag.
- A `from` or `to` that isn't a date gets `400 bad_date`.

```bash
curl "https://app.ownyourclick.com/api/v1/links/LINK_ID/stats?from=2026-10-01" -H "Authorization: Bearer oyc_YOUR_KEY"
```

```json
{ "from": 1790812800000, "to": 1792152000000, "clicks": 812, "uniques": 640, "conversions": 37,
  "timeline": [ { "day": "2026-10-01", "clicks": 41 }, { "day": "2026-10-02", "clicks": 58 } ] }
```

- `GET /links/:id/engagement`: visit by visit, active and total seconds and clicks (`active` leaves out time the tab was hidden or the visitor idle), with averages.
- `GET /links/:id/leads`: the leads one link brought. For a UTM link, that's the leads its clicks brought to the page they led to, each named with that page, the same leads its `leads` count shows.

### Visits

`GET /visits` (add `campaign_id` for one page): `visits`, `visitors`, `direct_visits`, `link_visits`, `return_visits`, average active and total seconds, and visits per visitor.

### Lead forms

`GET /forms` lists your forms with their address, `status`, `visits` and `submissions`. A form tracked with statuses also has a `page_id`: use it with the page calls to read its leads' statuses and change them.

```bash
curl "https://app.ownyourclick.com/api/v1/forms/FORM_ID/submissions?from=2026-10-01" -H "Authorization: Bearer oyc_YOUR_KEY"
```

Each submission has `data` (the answers, under their question labels such as `Name` and `Phone`), `fields` (the same answers under the form's own field ids), `ts`, `source` (the `utm_source` of the link they came through, if any), `referrer` (the site they came from, if known), `country`, `city`, `device`, `browser`, and `status` when the form tracks statuses.

## The API: status emails and sequences

Read a page's status emails and sequences, and add new ones (saved switched off). (On Team and Agency.)

### Read a page's emails

```bash
curl https://app.ownyourclick.com/api/v1/pages/PAGE_ID/email \
  -H "Authorization: Bearer oyc_YOUR_KEY"
```

Answers with the page's `statuses` (id and label), `statusEmails`, `sequences`, `gmailConnected` and `sendTime` (minutes after midnight, and the time zone).

### Add status emails and sequences

```bash
curl -X POST https://app.ownyourclick.com/api/v1/pages/PAGE_ID/email/import \
  -H "Authorization: Bearer oyc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "statusEmails": [{ "name": "Welcome", "status": "New Lead", "subject": "Thanks, {first_name|there}", "body": "Hi {first_name|there}, ..." }] }'
```

```json
{ "added": { "statusEmails": 1, "sequences": 0 }, "skipped": [], "switchedOff": true }
```

- The body is the same as [the format Claude and ChatGPT write](https://ownyourclick.com/docs#emails-with-ai): statuses by name or id, waits in minutes, plain `body` or designed `blocks`.
- Each call **adds**; nothing already there changes. Up to 30 status emails and 20 sequences a page.
- Everything added is **switched off**. A person switches it on in Automations → Email, so nothing goes to leads unchecked.
- `skipped` says, in words, what couldn't be used (usually a status name that isn't on the page).
- `403 not_available`: email automations aren't open for this workspace yet.

## Webhooks: each lead, the moment it arrives

Send every lead to Zapier, Make or your own server as it arrives, with where it came from and how engaged they were.

A UTM link's leads can go to any https address: on the link's **Settings** tab, set **Send leads to**, such as `https://hooks.zapier.com/…`. (A page's leads go to its [Google Sheet](https://ownyourclick.com/docs#sheets); to get them in another app, use the [API](https://ownyourclick.com/docs#api-leads).)

Each lead is a `POST` with a JSON body:

```json
{
  "id": "ld_3f1c…",
  "lead": { "name": "Priya", "email": "priya@example.com", "phone": "+91 98765 43210" },
  "tracking": {
    "utm_source": "instagram", "utm_medium": "social", "utm_campaign": "diwali",
    "source": "Instagram", "first_source": "YouTube", "visit_number": 2,
    "engaged_seconds": 214, "scroll_pct": 90, "total_clicks": 6, "hot_pct": 82,
    "page_url": "https://yourbrand.com/webinar", "referrer": "instagram.com",
    "country": "IN", "city": "Chennai", "device": "mobile", "browser": "Chrome",
    "submitted_at": "2026-10-16T10:22:31.000Z"
  }
}
```

`tracking` also has the click id, the link's own tags (as `link.<name>`), the buttons they clicked and whether they came by the link or directly.

Answer with any 2xx to say you got it (a JSON body with `"ok": false` counts as not delivered). It waits up to 25 seconds. The link's **Leads** tab shows each lead's delivery: **Sent**, **Not sent** or **Sending**.

Keep the lead's `id`: it's the `lead_id` for [changing its status](https://ownyourclick.com/docs#api-status) later.

## Troubleshooting and help

The usual reasons something isn't showing up, and how to fix each one.

### The page says "Code not found"

The tag hasn't been seen on your page yet. Check that it's in the page's `<head>` and that the site is published (Webflow and Framer need a publish), then open the page in a browser. The **Setup status** on the Settings tab re-checks every 10 seconds.

### Visits come in but no leads

- The form may not be a plain `<form>`, or it may be a different form than `data-form` points to. See **Check which forms are captured** on the Settings tab, and [Tracking code](https://ownyourclick.com/docs#tracking-code).
- A multi-step or JavaScript form: send the lead with `oyc('submit', { … })` once it's complete, and remove `data-form`.
- A form inside an iframe (some booking and survey tools) can't be read from your page.

### Leads aren't reaching my Google Sheet

Open **Configure Sheets**: it says how many didn't get there. Press **Resend N**. If the workspace has no plan, leads wait until you pick one, then press **Resend**. If the sheet runs an older copy of the script, copy the new script and redeploy.

### Statuses changed in the sheet don't come back

Only a connected Google sheet (**Connect Google and create my sheet**) sends changes back, within about 30 seconds. A sheet you connected with the Apps Script only receives leads.

### A status I changed doesn't reach my sheet or start an automation

Turn on **Lead statuses** on the page's **Automations** tab. The same goes for the API (`409 statuses_off`).

### The dashboard is closed

The trial or plan has ended. Open **Billing** and pick a plan; nothing was deleted.

### Still stuck?

Email [support@ownyourclick.com](mailto:support@ownyourclick.com). A person reads every message.
