n8n-nodes-waalaxy

This is an n8n community node that integrates Waalaxy with your n8n workflows. Waalaxy is a LinkedIn automation tool that helps you automate your prospecting and outreach campaigns.

Table of Contents

• Features
• Installation
• Credentials
• Operations
  • Prospect
• Usage Examples
• Development
• Resources
• License

Features

• 🚀 Add Prospects — Import prospects into Waalaxy from any source via n8n
• 📋 Prospect Lists — Dynamically select and manage prospect lists
• 🎯 Campaign Integration — Automatically add prospects to campaigns
• 🔄 Duplicate Handling — Control how duplicates are managed

Installation

Community Nodes (Recommended)

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Select Install
4. Enter @waapi/n8n-nodes-waalaxy in the input field
5. Agree to the risks of using community nodes
6. Click Install

Manual Installation

To install this node manually, run the following command in your n8n installation directory:

npm install @waapi/n8n-nodes-waalaxy

Then restart your n8n instance.

Credentials

Before using this node, you need to configure your Waalaxy API credentials.

Setting Up Credentials

1. In n8n, go to Credentials > New Credential
2. Search for Waalaxy API
3. Enter your Access Token
4. Click Save

Obtaining Your Access Token

1. First, you need to create Waalaxy account
2. Log in to your Waalaxy account
3. Navigate to your Settings, Integrations section
4. Generate an access token
5. Copy the token and paste it into n8n

Note: Keep your access token secure and never share it publicly.

Operations

Prospect

Add to List and Campaign

Add prospects to a prospect list and optionally enroll them in a campaign.

Prospect Fields:

Usage Examples

Example 1: Bulk Import from Google Sheets

1. Google Sheets node — Read prospect data from a spreadsheet
2. Waalaxy node — Add prospects to your list and campaign

[Google Sheets] → [Waalaxy: Add to List and Campaign]

Example 2: Webhook Integration

Automatically add new leads to Waalaxy when a form is submitted:

[Webhook Trigger] → [Waalaxy: Add to List and Campaign]

Example 3: CRM Integration

Sync prospects from your CRM to Waalaxy campaigns:

[HubSpot/Salesforce] → [Filter] → [Waalaxy: Add to List and Campaign]

Development

Prerequisites

• Node.js (v18 or higher recommended)
• npm or pnpm
• n8n installed locally for testing

Setup

1. Clone the repository:

git clone https://github.com/Waapi-Pro/n8n-nodes-waalaxy.git
cd n8n-nodes-waalaxy

2. Install dependencies:

npm install

3. Build the project:

npm run build

Available Scripts

Testing Locally

To test the node locally with n8n:

1. Build the node:

npm run build

2. Link the node to your global n8n installation:

npm link

3. In your n8n directory, link the package:

npm link @waapi/n8n-nodes-waalaxy

4. Start n8n:

n8n start

Alternatively, use the development mode:

npm run dev

Project Structure

n8n-nodes-waalaxy/
├── credentials/
│   └── WaalaxyApi.credentials.ts    # API credentials configuration
├── nodes/
│   └── Waalaxy/
│       ├── listSearch/              # Dynamic list loading functions
│       │   ├── getCampaigns.ts      # Fetch available campaigns
│       │   └── getProspectLists.ts  # Fetch available prospect lists
│       ├── resources/
│       │   └── prospect/            # Prospect resource operations
│       │       ├── index.ts
│       │       └── addToListAndCampaign.ts
│       ├── shared/
│       │   ├── descriptions.ts      # Shared UI components
│       │   └── transport.ts         # API request helper
│       ├── Waalaxy.node.ts          # Main node definition
│       └── Waalaxy.node.json        # Node metadata
├── icons/                           # Node icons (light/dark themes)
├── dist/                            # Compiled output
├── package.json
└── tsconfig.json

Support

If you encounter any issues or have questions:

• Open an issue on GitHub
• Contact the author at fabien.turgut@waalaxy.com