# Geysera Signal — developer documentation

> Signal identifies the companies behind anonymous traffic on a website.
> This documentation covers the read API, webhooks, and a copilot endpoint
> that answers natural-language questions about a workspace.

The public API is READ-ONLY. Keys reach reads; changes are made in the
dashboard or by asking the copilot in a signed-in session, where each one
is described and confirmed before it runs.

Everything below is also available as one file: https://app.signal.geysera.com/developers/llms-full.txt

Machine-readable capabilities, derived from the running service:
https://app.signal.geysera.com/agent-api/capabilities

The endpoint-by-endpoint reference is generated from that endpoint and
lives at https://www.geysera.com/developers. Prefer /agent-api/capabilities to
either page: it is the source both are built from.

## Get started

- [Quickstart](https://app.signal.geysera.com/developers/quickstart.md): Create a key and make your first call.

## Guides

- [Developer guide](https://app.signal.geysera.com/developers/guide.md): The three surfaces, conventions, the copilot, webhooks, and the things that will surprise you.

## Workflows

- [Receive identified visitors by webhook](https://app.signal.geysera.com/developers/workflows/receive-identified-visitors-by-webhook.md): Get a POST the moment a visitor is identified, and not miss any.
- [Export and keep in sync](https://app.signal.geysera.com/developers/workflows/export-and-keep-in-sync.md): Pull the account list once, then keep it current without refetching it all.
- [Ask questions in natural language](https://app.signal.geysera.com/developers/workflows/ask-questions-in-natural-language.md): Use the copilot from code, and read the parts of the answer that matter.
- [Alert your team when a target account appears](https://app.signal.geysera.com/developers/workflows/alert-your-team-when-a-target-account-appears.md): Filter the webhook against your named-account list and post to Slack within minutes.
- [Build a daily call list](https://app.signal.geysera.com/developers/workflows/build-a-daily-call-list.md): One call, a ranking you can read, and a prompt that is willing to say leave this one alone.
- [Write a first-touch email from what they read](https://app.signal.geysera.com/developers/workflows/write-a-first-touch-email-from-what-they-read.md): An opener grounded in real behaviour, with the SKIP rule that stops it inventing one.
- [Spot a buying committee](https://app.signal.geysera.com/developers/workflows/spot-a-buying-committee.md): Three people from one company in a week is one deal, not three leads.
- [Notice an account going quiet](https://app.signal.geysera.com/developers/workflows/notice-an-account-going-quiet.md): The cheapest churn signal you have, weeks before the renewal conversation.
- [Fill your CRM with who is actually visiting](https://app.signal.geysera.com/developers/workflows/fill-your-crm-with-who-is-actually-visiting.md): Compare the two account sets first; the gap is usually not the one you assumed.
- [Find the pages that create pipeline](https://app.signal.geysera.com/developers/workflows/find-the-pages-that-create-pipeline.md): Rank content by who it brings rather than how many, and read the coverage first.
- [Score and route inbound leads](https://app.signal.geysera.com/developers/workflows/score-and-route-inbound-leads.md): Use what someone did before the form to decide who should get it.
- [Keep an ad audience in sync](https://app.signal.geysera.com/developers/workflows/keep-an-ad-audience-in-sync.md): Suppress customers, retarget high intent, and the consent questions to answer first.
- [A weekly revenue brief your LLM writes](https://app.signal.geysera.com/developers/workflows/a-weekly-revenue-brief-your-llm-writes.md): Gather deterministically, write with a model, and propagate the disclosures.
- [Watch your own data quality](https://app.signal.geysera.com/developers/workflows/watch-your-own-data-quality.md): The workflow that protects every other workflow: knowing when the data went quiet.

## Playbooks

- [Account-based marketing, end to end](https://app.signal.geysera.com/developers/playbooks/account-based-marketing-end-to-end.md): Six stages, the two that carry the value, and the human gate to keep.
- [Turning content into pipeline](https://app.signal.geysera.com/developers/playbooks/turning-content-into-pipeline.md): Measure content on who it brings, then prove the change with a causal test.
- [Let an LLM run your workspace](https://app.signal.geysera.com/developers/playbooks/let-an-llm-run-your-workspace.md): The response contract, refusals, the confirmation gate, and what a key can never do.

## Case studies

- [Most of your visitors were not people](https://app.signal.geysera.com/developers/case-studies/most-of-your-visitors-were-not-people.md): 69% of one account's events were unflagged crawlers.
- [The pipeline that reported success while doing nothing](https://app.signal.geysera.com/developers/case-studies/the-pipeline-that-reported-success-while-doing-nothing.md): A job that caught its own failure and completed, for days.
- [Why attribution covers less than you think](https://app.signal.geysera.com/developers/case-studies/why-attribution-covers-less-than-you-think.md): The ceiling is structural, and knowing the number is the useful part.