Skip to main content

n8n Integration

This guide explains how to use n8n to automatically sync contact data from n8n to your Orkap Contacts library via an incoming webhook. I will use Google Sheets but you can use any data source for n8n. The process is similar for any other data source.

Prerequisites​

  • An active Orkap account
  • An n8n instance (cloud or self-hosted)
  • A Google Sheets document with contact data (optional, documentation purpose only)

Step 1: Create an Incoming Webhook in Orkap​

First, generate the incoming webhook in Orkap that will receive data from n8n.

  1. Log in to your Orkap dashboard
  2. Navigate to the Webhooks section
  3. Click on "Create Webhook"
  4. Copy the generated webhook URL
  5. Save this URL for use in your n8n workflow

[SCREENSHOT: Orkap webhook creation screen with the new URL visible]

Step 2: Set Up the n8n Workflow​

Create a new workflow in n8n with the following nodes:

Node 1: Manual Trigger​

  • Purpose: Starts the workflow execution
  • Configuration: Default settings
  • Notes: This can be replaced with a schedule trigger for automation

[SCREENSHOT: n8n interface showing the Manual Trigger node]

Node 2: Google Sheets Node (your prefered data source)​

  • Purpose: Reads contact data from your spreadsheet
  • Configuration:
    • Authentication: Connect your Google account
    • Document ID: Your Google Sheets document ID
    • Sheet Name: The specific sheet to read from
    • Operation: "Read Rows"

[SCREENSHOT: Google Sheets node configuration]

Node 3: Split In Batches Node​

  • Purpose: Processes contacts one at a time
  • Configuration:
    • Batch Size: 1
    • Options: Default settings

[SCREENSHOT: Split In Batches node configuration]

Node 4: Wait Node​

  • Purpose: Adds delay between requests to avoid rate limiting
  • Configuration:
    • Time Interval: 1 second
    • Unit: Seconds

[SCREENSHOT: Wait node configuration]

Node 5: HTTP Request Node​

  • Purpose: Sends data to Orkap's webhook
  • Configuration:
    • Method: POST
    • URL: Your Orkap webhook URL from Step 1
    • Query Parameters:
      • name: ={{ $json.name }} (maps to name field)
      • email: ={{ $json.email }} (maps to email field)
    • Options: JSON format

[SCREENSHOT: HTTP Request node configuration showing parameter mapping]

Step 3: Configure the Workflow Connections​

Connect the nodes in this order:

  1. Manual Trigger → Google Sheets
  2. Google Sheets → Split In Batches
  3. Split In Batches → Wait
  4. Wait → HTTP Request
  5. HTTP Request → Split In Batches (loop)

[SCREENSHOT: Complete workflow diagram showing all connections]

Step 4: Test and Activate the Workflow​

  1. Click "Execute workflow" on the Manual Trigger node
  2. Monitor the execution in the "Execution" tab
  3. Check for green success indicators on all nodes
  4. Verify contacts appear in your Orkap dashboard
  5. Activate the workflow when testing is successful

[SCREENSHOT: Successful workflow execution with all green nodes]

Step 5: Automate the Workflow (Optional)​

Replace the Manual Trigger with a Schedule trigger for automatic operation:

  • Set appropriate intervals (hourly, daily, etc.)
  • Configure timezone settings
  • Test the automated execution

[SCREENSHOT: Schedule trigger configuration]

Data Mapping Reference​

The workflow expects your Google Sheets to have these columns:

  • name: Contact's full name
  • email: Contact's email address

Additional fields can be added to the HTTP Request node as needed.

Summary​

This n8n workflow provides a powerful way to add contacts from any data source to Orkap. The batch processing ensures reliable data transfer even with large contact lists, while the delay between requests prevents API rate limiting.

Key Features:

  • Batch processing for reliability
  • Configurable delay between requests
  • Easy-to-modify field mapping
  • Flexible triggering options