Getting started

Updated 2026-11-02

Let an agent do it

Paste this into Claude Code, Cursor or any coding agent, from your site's repo:

Read https://headstream.app/agent.md and set up Headstream on this site.

The agent does each step below and asks you when a step needs a person.

Do it yourself

1. Create a project

Sign up at headstream.app and add a project with your domain, such as example.com. Subdomains are included.

A project holds one site or product. If your marketing site and app share a Stripe account, put both domains in one project.

2. Install the script

Copy the snippet from the Install card under Project in the dashboard. Paste it into the shared <head> of your site.

<script defer src="https://headstream-ingest.super-dream-7005.workers.dev/t.js" data-key="YOUR_KEY"></script>

Always copy it from your settings, since that version holds your key. See install the script, or the integrations for your stack.

3. Confirm it works

Load a page on your real domain, then check the dashboard. Events from localhost are rejected, because localhost can't be added to a project.

4. Set a goal

Open Goals and add your main conversion, such as a /thanks page or a signup event. See goals.

5. Ask how people found you

Add a field named heard_about to your signup form. Tracking can't see podcasts, word of mouth or AI answers, and this shows you what it misses. See self-reported attribution.

6. Connect Stripe

In Project, click Connect Stripe with read-only access. Connecting Stripe is in beta. See connect Stripe.

What to do next

• Identify people at signup so that payments link to their visits.
• Build reports and dashboards.
• Connect your tools through the API or MCP server.