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

# n8n integration

> Use the StoreInspect community node in n8n to automate Shopify store and contact intelligence workflows.

The official StoreInspect community node for n8n lets you search and enrich Shopify stores, find decision-maker contacts, and reveal verified contact details inside automated workflows. It requires a paid StoreInspect plan with API access.

<Note>
  StoreInspect is a verified community node and is available directly in n8n Cloud.
</Note>

## Install the node

### n8n Cloud

1. Open or create a workflow.
2. Select **Add first step** or add another node.
3. Search for **StoreInspect**.
4. Add the verified StoreInspect node to the workflow.

### Self-hosted n8n

1. Confirm that **Verified Community Nodes** is enabled in the n8n Admin Panel.
2. Restart the instance after upgrading n8n or enabling verified community nodes.
3. Open a workflow and search for **StoreInspect** in the nodes panel.

If the verified node is unavailable in an older self-hosted release, open **Settings > Community Nodes**, select **Install**, and enter `@storeinspect/n8n-nodes-storeinspect`.

The package is available on [npm](https://www.npmjs.com/package/@storeinspect/n8n-nodes-storeinspect). See [n8n's community-node installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) if your instance does not support installation through the settings interface.

## Connect StoreInspect

1. In StoreInspect, open **Settings > API**.
2. Create a dedicated API key named `n8n`.
3. Add a **StoreInspect** node to an n8n workflow.
4. Create a **StoreInspect API** credential and paste the API key.
5. Run **Usage > Get** to confirm the connection.

The usage operation returns your StoreInspect plan, API request allowance, search-row usage, and contact-credit balance.

## Available operations

### Store

* **Search** finds Shopify stores using category, country, traffic, estimated revenue, technology, Shopify Plus, theme, Meta ads, and contact-availability filters.
* **Get** retrieves one Shopify store by domain or URL.
* **Enrich** enriches up to 25 domains with store intelligence, technologies, and optional contact previews.

### Contact

* **Search** finds masked decision-maker contact previews using person and company filters.
* **Reveal** reveals verified details for up to 10 contact IDs using StoreInspect contact credits.

### Usage

* **Get** returns plan, API request, search-row, and contact-credit usage for the connected account.

## Search Shopify stores

1. Add a **StoreInspect** node.
2. Select **Store** as the resource and **Search** as the operation.
3. Add at least one positive filter, such as country, category, technology, traffic tier, or revenue tier.
4. Choose whether to return all results or set a result limit.
5. Execute the node and map the returned store items into later workflow steps.

Store and contact searches follow StoreInspect cursors automatically. Each matching result is returned as a separate n8n item.

## Enrich known domains

Use **Store > Enrich** when your workflow already has Shopify domains:

1. Enter or map up to 25 domains or URLs.
2. Choose whether to include store data, technologies, and contact previews.
3. Optionally select contact roles and the maximum number of previews per store.
4. Execute the node and map the enriched items into later steps.

Contact previews are masked and do not expose email addresses or phone numbers.

## Search and reveal contacts

Use **Contact > Search** to return masked contact previews and StoreInspect contact IDs. Filter by store domain, role, seniority, verified email, phone, LinkedIn availability, or store criteria.

To reveal selected contacts:

1. Add a second StoreInspect node with **Contact > Reveal**.
2. Map up to 10 contact IDs from a search or enrichment step.
3. Set a stable idempotency key when the workflow may retry the same reveal request.
4. Execute the node and map the revealed fields into later actions.

Each newly revealed contact uses one StoreInspect contact credit. Reusing the same idempotency key for the same request prevents an automatic retry from spending credits twice.

## Errors

* **Invalid or revoked API key:** Create or rotate a key under **Settings > API**, then update the n8n credential.
* **API access unavailable:** Confirm that the StoreInspect account has an active plan with API access.
* **No positive filter:** Add a country, category, role, technology, traffic tier, revenue tier, or another narrowing filter.
* **Rate limit reached:** Retry after the StoreInspect rate-limit window resets.
* **Insufficient contact credits:** Add credits or change your StoreInspect plan before revealing another new contact.
* **Node not visible on a self-hosted instance:** Enable **Verified Community Nodes**, update or restart n8n, then search again.

StoreInspect errors include a request ID when available. Include it when contacting support about a failed node execution.

## Update or remove the node

n8n Cloud receives approved StoreInspect node updates automatically. On self-hosted n8n, restart the instance if a newly published version does not appear immediately.

To stop access completely:

1. Remove or update the StoreInspect credential in n8n.
2. Revoke the corresponding API key under **Settings > API** in StoreInspect.

Removing only the n8n credential deletes the saved key from n8n. Revoking the key in StoreInspect prevents any retained copy from being used again.

## Resources

* [StoreInspect node on npm](https://www.npmjs.com/package/@storeinspect/n8n-nodes-storeinspect)
* [Source code and issue tracker](https://github.com/StoreInspect/n8n-nodes-storeinspect)
* [StoreInspect API documentation](/docs/api-reference/introduction)
* [n8n community-node documentation](https://docs.n8n.io/integrations/community-nodes/installation/)