n8n-nodes-idb2b

An n8n community node for integrating with IDB2B — AI Agents that turn conversations into customers for WhatsApp, Instagram & TikTok.

n8n is a workflow automation platform.

What is this node?

IDB2B is an AI Agents platform that converts conversations into customers across WhatsApp, Instagram, and TikTok. This node lets you connect n8n to your IDB2B account to automate contact and company management — create, read, update, and delete records without writing code.

Installation

Follow the installation guide in the n8n documentation, or install directly:

npm install n8n-nodes-idb2b

Credentials

1. In n8n, go to Credentials → New → IDB2B WhatsApp AI Agents
2. Fill in:
   • Email: Your IDB2B account email
   • Password: Your IDB2B account password
   • Base URL: https://api.idb2b.com (default)
3. Click Test connection to verify, then Save

Resources & Operations

Contact

Company

How to Use

Basic workflow

1. Add the IDB2B CRM node to your workflow
2. Select your saved credential under Credential to connect with
3. Choose a Resource (Contact or Company)
4. Choose an Operation (Get All, Get, Create, Update, Delete)
5. Fill in the required parameters and execute

Get All Contacts

• Limit: Number of contacts per page (default: 50)
• Page: Page number (default: 1)
• Fields to Return: Optionally select specific fields (id, name, email, phone_number, tags, etc.)
• Query Parameters: Add any extra filters supported by the API

Get All Companies

• Limit: Number of companies per page (default: 50)
• Page: Page number (default: 1)
• Fields to Return: Optionally select specific fields
• Query Parameters: Add any extra filters

Create Contact

Required:

• Name: Contact full name
• Email: Valid email address

Optional (under Additional Fields):

• Phone Number, User ID, Lead ID, Favorites, Tags

Create Company

Required:

• Name: Company name

Optional (under Additional Fields):

• Any additional company fields supported by the API

Example Workflows

Retrieve all contacts and companies

Manual Trigger → Get all contacts → Get all companies

Sync new contacts from a webhook

Webhook → IDB2B Create Contact
  - Name: {{ $json.name }}
  - Email: {{ $json.email }}
  - Phone: {{ $json.phone }}

Paginate through all contacts

Schedule Trigger → IDB2B Get All Contacts
  - Limit: 100
  - Page: 1

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Lint
npm run lint

Version History

v2.0.3

• Fixed endpoint paths (/contacts, /companies)
• Fixed access token parsing from login response
• Added Company resource with full CRUD operations

v1.0.4

• Added pagination, field selection, and token caching
• Enhanced error handling with HTTP status codes

v1.0.3

• Initial release with basic contact CRUD operations

License

MIT