> ## 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>
  The StoreInspect node is undergoing n8n verification. Until verification is complete, install it from npm on a self-hosted n8n instance. Unverified community nodes are not available on n8n Cloud.
</Note>

## Install the node

1. In your self-hosted n8n instance, open **Settings > Community Nodes**.
2. Select **Install**.
3. Enter `@storeinspect/n8n-nodes-storeinspect` as the npm package name.
4. Accept the community-node risk notice and complete the installation.
5. Open a workflow and search for **StoreInspect** in the nodes panel.

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.
* **Package not available in n8n Cloud:** Use a self-hosted n8n instance until the StoreInspect node completes verification.

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

## Update or remove the node

Manage the package under **Settings > Community Nodes** in n8n. After updating the package, restart n8n if the new 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/)