---
title: N8N
description: Learn how to connect TheirStack with N8N — pull job postings and company data via HTTP Request nodes, or automate real-time notifications through webhooks.
url: https://theirstack.com/en/docs/integrations/n8n
---

[N8N](https://n8n.io) is an open-source workflow automation platform that you can self-host or use via [n8n.cloud](https://n8n.cloud). It connects hundreds of services and lets you build powerful automations with a visual editor.

There are two ways to integrate TheirStack with N8N:

-   **Webhook trigger** (recommended) — Receive real-time notifications whenever new jobs or companies match your search criteria. No code, no scheduling, no API calls to manage.
-   **HTTP Request node** — Pull job postings, [company data](/en/docs/data/company), or technographic information on-demand by calling the TheirStack API directly from an N8N workflow.

## Webhooks — the recommended approach

Webhooks are the easiest and most reliable way to connect TheirStack with N8N. Instead of polling the API on a schedule, TheirStack pushes new results directly to your workflow the moment they appear — with built-in deduplication, so you never process the same job twice or waste [API credits](/en/docs/pricing/credits) on duplicate retrievals.

1.  **Create a new workflow in N8N.**
    
2.  **Add a **Webhook** trigger node and set the HTTP method to `POST`.**
    
3.  **Copy the **webhook URL** displayed in the node.**
    
4.  **[Create a webhook in TheirStack](/en/docs/webhooks/how-to-set-up-a-webhook) using the N8N webhook URL.** Configure the search filters directly in TheirStack — no need to replicate them in N8N.
    
5.  **Add downstream nodes to process the data** — for example, send a Slack message, update a CRM, or write to a spreadsheet.
    
6.  **Activate the workflow so it listens for incoming [webhooks](/en/docs/webhooks).**
    

For a detailed walkthrough, see [How to send jobs to Slack](/en/docs/guides/how-to-send-jobs-to-slack).

### Why webhooks over the API?

|  | Webhooks | HTTP Request (API) |
| --- | --- | --- |
| **Setup complexity** | Minimal — paste a URL in TheirStack | Requires configuring auth, headers, body, and [pagination](/en/docs/api-reference/pagination) |
| **Real-time** | Yes — triggered instantly on new results | No — runs on a schedule you define |
| **[API credits](/en/docs/pricing/credits)** | Only charged for genuinely new results | Each record costs 1 credit per fetch — duplicates are charged again |
| **Deduplication** | Built-in — TheirStack only sends new results | You must implement deduplication yourself (e.g. tracking `discovered_at` timestamps or excluding already-seen `job_id`s) |
| **Filter management** | Managed in TheirStack UI | Duplicated in N8N node configuration |

The API is best suited for user-triggered actions (enrichment, one-off lookups) rather than [periodic data syncing](/en/docs/guides/fetch-jobs-periodically). If you're building a scheduled workflow to pull new jobs, webhooks are the right tool for the job.

## Alternative: Pull data with the HTTP Request node

##### Consider using webhooks instead

If you're building a workflow to periodically sync new jobs or companies, [webhooks](#webhooks--the-recommended-approach) are the better choice. The API approach requires you to handle pagination, deduplication, and scheduling yourself — and every record returned costs 1 [API credit](/en/docs/pricing/credits), even duplicates. Webhooks deliver only new results, in real-time, with no extra logic needed.

If you need to pull data on-demand — for example, to enrich records from another node or to run a one-off query — you can call the TheirStack API directly using N8N's HTTP Request node.

### Quick setup from TheirStack App

The fastest way to get started is to copy a pre-configured HTTP Request node directly from the TheirStack app:

1.  **Go to [app.theirstack.com](https://app.theirstack.com), run a job or [company search](/en/docs/app/company-search) with your desired filters, and click the **API** button.**
    
2.  **Select the **N8N** tab and click **Copy HTTP Request**.** This copies a fully configured N8N HTTP Request node to your clipboard — including your API key, headers, and search filters.
    
3.  **Go to your N8N instance, open your workflow, and paste with **CTRL+V** (Windows) or **CMD+V** (Mac).** The HTTP Request node will appear pre-configured and ready to execute.
    

### Manual setup

If you prefer to configure the HTTP Request node manually:

1.  **Create a new workflow in N8N or open an existing one.**
    
2.  **Add an **HTTP Request** node to your workflow.**
    
3.  **Configure the node with the following settings:**
    
    -   **Method**: `POST`
    -   **URL**: `https://api.theirstack.com/v0/jobs/search` (or `/v0/companies/search` for companies)
    -   **[Authentication](/en/docs/api-reference/authentication)**: Select **Header Auth** and set:
        -   **Name**: `Authorization`
        -   **Value**: `Bearer YOUR_API_KEY` ([get your API key](/en/docs/api-reference/authentication#getting-your-api-key))
    -   **Send Headers**: Enable and add:
        -   `Content-Type`: `application/json`
    -   **Send Body**: Enable, set **Body Content Type** to `JSON`, and add your search filters:
        
        ```
        {
          "job_title_or": ["software engineer", "developer"],
          "posted_at_max_age_days": 7,
          "limit": 25
        }
        ```
        
4.  **Click **Execute Node** to test and inspect the output.**
    

See the [API Reference](/en/docs/api-reference) for all available endpoints and filter options.

## Use cases

-   **Real-time job alerts** (webhook): Get notified the moment a new job is posted matching your criteria — send to Slack, email, or a spreadsheet.
-   **CRM enrichment** (API): Pull technographic data about companies in your CRM and route enriched records back using N8N's CRM nodes (HubSpot, Salesforce, etc.).
-   **Lead routing** (webhook): Automatically route new job postings to the right sales rep based on company size, location, or tech stack.

## Frequently asked questions

### Can I self-host N8N and use it with TheirStack?

Yes. TheirStack works with any N8N instance — whether self-hosted or running on [n8n.cloud](https://n8n.cloud). For webhooks, ensure your instance is reachable from the internet (TheirStack needs to send HTTP requests to your webhook URL). For API calls, ensure your instance can make outbound HTTPS requests to `api.theirstack.com`.

### What is the difference between the HTTP Request node and Webhook trigger?

The **Webhook trigger** is the recommended approach — TheirStack pushes data to N8N in real-time whenever new results match your saved search. No scheduling, no pagination, no wasted API calls. The **HTTP Request node** is useful when you need to pull data on-demand, such as enriching records from another node or running a one-off query.

### How do I handle pagination in N8N?

Pagination only applies when using the HTTP Request node (webhooks handle this automatically). The TheirStack API supports `limit` and `page` parameters. To paginate through results in N8N, use a **Loop Over Items** node or a **SplitInBatches** node to iterate through pages, incrementing the `page` parameter on each iteration until no more results are returned.