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

# n8n Webhook Automation: Automate Linkstonic Workflows

> Connect Linkstonic to n8n to trigger tracking, audits, and reports automatically. Build custom AI visibility workflows with callback URL support.

The Linkstonic n8n webhook API lets you trigger Linkstonic actions directly from n8n automation workflows, without manual intervention. If you are an Agency user managing multiple clients or running recurring AI visibility programs, you can use n8n to schedule tracking runs, auto-generate reports, sync data to external tools, and build custom dashboards — all driven by Linkstonic data.

<Note>
  The n8n Webhook API is an Agency-only feature. Contact [Linkstonic support](mailto:support@linkstonic.com) to enable it on your account.
</Note>

## What you can trigger

Each webhook call to Linkstonic specifies an action type. The following actions are supported:

* **track** — Run AI tracking for a specific brand and keyword combination. Use this to pull fresh visibility data on demand or on a schedule.
* **analyze** — Run a TrueTrace audit for a URL or brand. Use this to assess how a page or brand is represented across AI platforms.
* **report** — Generate and export a summary report for a brand or keyword set. Use this to produce client-ready outputs automatically.
* **monitor** — Check the current AI visibility status for a tracked entity. Use this as a lightweight health check without triggering a full tracking run.

## Callback URL support

When you trigger an action via n8n, Linkstonic can send the results back to your workflow asynchronously via a **callback URL**. You provide the callback URL as part of the webhook payload, and once Linkstonic completes the action, it sends the output to that URL.

This means your n8n workflow does not need to poll for results. Instead, it waits for Linkstonic to push the data back, which keeps your workflows clean and avoids unnecessary API calls.

<Tip>
  Always configure a callback URL in your n8n workflows. This way, results are pushed back to your workflow automatically as soon as they are ready — no polling logic required.
</Tip>

## Example use cases

<CardGroup cols={2}>
  <Card title="Weekly AI visibility reports" icon="file-chart-line">
    Schedule a weekly n8n workflow that triggers a **report** action in Linkstonic and emails the output to your team automatically.
  </Card>

  <Card title="Audit on site update" icon="magnifying-glass">
    Trigger an **analyze** action in Linkstonic whenever a client's site is updated, so you always have a fresh TrueTrace audit on hand.
  </Card>

  <Card title="Sync to Google Sheets" icon="table">
    Use a **track** action with a callback URL to receive results in n8n, then write them directly to a Google Sheet for ongoing tracking.
  </Card>

  <Card title="Slack visibility threshold alert" icon="bell">
    Use a **monitor** action on a schedule. If AI visibility drops below a threshold, trigger an n8n Slack node to alert your team.
  </Card>
</CardGroup>

## How to configure the n8n integration

<Steps>
  <Step title="Upgrade to Agency plan">
    The n8n Webhook API requires an Agency plan. Confirm your plan status in **Account Settings**, or contact support to upgrade.
  </Step>

  <Step title="Get your API credentials from Linkstonic">
    In your Linkstonic dashboard, go to **Settings → API** and copy your API key. You will use this to authenticate webhook requests from n8n.
  </Step>

  <Step title="In n8n, add an HTTP Request node">
    Open your n8n workflow and add an **HTTP Request** node. Set the method to `POST` and enter the Linkstonic webhook endpoint URL.
  </Step>

  <Step title="Configure the webhook endpoint with your action type">
    In the request body, specify your action type (`track`, `analyze`, `report`, or `monitor`) along with the required parameters such as brand name, keyword, or URL.
  </Step>

  <Step title="Add an optional callback URL">
    If you want results pushed back to your workflow, add a `callback_url` field to the request body. Point it to an n8n Webhook node that will receive and process the response.
  </Step>

  <Step title="Test the workflow">
    Run the workflow manually in n8n to verify that Linkstonic receives the request and returns the expected data to your callback URL. Check the n8n execution log for any errors.
  </Step>
</Steps>