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

# gtm_audit

> Run an org-aware GTM audit of a prospect's website.

Runs a full go-to-market audit of a prospect's website, scoped to your organization's context.
This is a **long-running** pipeline: the tool starts the audit and returns immediately with a
run id. Poll [`get_run_status`](/tools/get-run-status) with `kind: "gtm-audit"` until it
completes.

<ParamField path="website" type="string" required>
  The prospect's website. A domain (`acme.com`) or full URL both work.
</ParamField>

**Type:** asynchronous · **Returns:** a run id and polling instructions

## Example call

```json theme={null}
{
  "name": "gtm_audit",
  "arguments": { "website": "acme.com" }
}
```

## Returns

The initial call returns markdown confirming the run started and how to poll it:

```markdown theme={null}
GTM audit started for acme.com. Poll `GET /api/v1/runs/gtm-audit/<id>`.
```

## Poll for the result

Call [`get_run_status`](/tools/get-run-status) with the audit id:

```json theme={null}
{
  "name": "get_run_status",
  "arguments": { "kind": "gtm-audit", "id": "<id>" }
}
```

While it runs you get a status line; once `completed` you get the full audit as markdown slides.

<Note>
  An audit can take several minutes. Poll on a reasonable interval rather than in a tight loop —
  see [Async runs](/reference/async-runs).
</Note>

## Notes

* Audits run scoped to your org's profile and any connected integrations.
* If your org hasn't completed onboarding, the call returns an `Onboarding required` message
  instead of starting a run.