npm package: @ivanlaomarketing/n8n-nodes-kartra
Description: n8n community node for Kartra - All-in-One Marketing Platform. Manage leads, tags, lists, sequences, calendars, transactions and more. Built by Ivan Lao (@ivanlaomarketing) - Marketing Automation Specialist & Make Certified Partner.
Author: Ivan Lao
Latest version: 1.0.1

# n8n-nodes-kartra

[![npm version](https://img.shields.io/npm/v/@ivanlaomarketing/n8n-nodes-kartra?color=orange&label=npm)](https://www.npmjs.com/package/@ivanlaomarketing/n8n-nodes-kartra)
[![n8n compatible](https://img.shields.io/badge/n8n-compatible-FF6347)](https://n8n.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Built by Ivan Lao](https://img.shields.io/badge/Built%20by-Ivan%20Lao-FF6B35)](https://laoivan.com)

> **The most complete n8n integration for Kartra** — manage leads, tags, lists, sequences, calendars, transactions and receive real-time webhook events.

[📦 npm](https://www.npmjs.com/package/@ivanlaomarketing/n8n-nodes-kartra) •
[💻 GitHub](https://github.com/ivanlaomarketing/n8n-nodes-kartra) •
[📖 Docs](https://github.com/ivanlaomarketing/n8n-nodes-kartra#readme) •
[🌐 laoivan.com](https://laoivan.com)

---

## Description

This n8n community node provides full integration with [Kartra](https://kartra.com),
the all-in-one marketing automation platform. Automate lead management, email marketing,
membership access, sales funnels, and more — directly from your n8n workflows.

Built with the **programmatic node style** for maximum flexibility with Kartra's
PHP-style API encoding.

---

## Features

- ✅ **15 Lead operations** — create, update, get, search leads; manage tags, lists, sequences, calendars, and lead scoring
- ✅ **4 Transaction operations** — retrieve transactions, subscriptions, and transaction details
- ✅ **1 Generic operation** — execute any Kartra API command with custom parameters
- ✅ **Kartra Trigger** — receive real-time webhook events with 12 event filters
- ✅ **Custom Fields** support — read and write Kartra custom field values
- ✅ **Automatic rate limit retry** — auto-retries on HTTP 429 (up to 3 times, 1000ms delay)
- ✅ **76 timezones** supported in the timezone dropdown
- ✅ **usableAsTool** — compatible with n8n AI agent workflows
- ✅ **npm provenance** — signed releases via GitHub Actions

---

## Installation

### Via n8n Community Nodes UI (Recommended)

1. Open n8n Settings → Community Nodes
2. Click **Install**
3. Enter: `@ivanlaomarketing/n8n-nodes-kartra`
4. Click **Install**

### Via npm (Self-hosted n8n)

```bash
npm install @ivanlaomarketing/n8n-nodes-kartra
```

Then restart n8n.

---

## Configuration

### Getting Your Kartra API Credentials

You need three values from your Kartra account:

| Field | Where to find it |
|-------|-----------------|
| **API Key** | Kartra → Settings → My Integrations → My API → API Key |
| **API Password** | Kartra → Settings → My Integrations → My API → API Password |
| **App ID** | Kartra → Settings → My Integrations → My Apps → App ID |

> **Note:** You must create a Developer App in Kartra first.
> Go to: Settings → My Integrations → My Apps → Create New App.
> The App ID is shown after creation.

### Setting Up Credentials in n8n

1. Add a **Kartra** node to your workflow
2. Click on **Credentials** → **Create New**
3. Fill in API Key, API Password, and App ID
4. Click **Save**

---

## Operations Reference

### Resource: Lead

| Operation | Description | Required Fields |
|-----------|-------------|----------------|
| **Create Lead** | Create a new lead in Kartra | Email |
| **Create Lead (Advanced)** | Create a lead with all fields + custom fields | Email |
| **Update Lead** | Update an existing lead | Email or Lead ID |
| **Get Lead** | Get full lead profile (tags, lists, transactions...) | Email |
| **Search Lead** | Check if a lead exists, returns lead ID | Email or Lead ID |
| **Add Lead to List** | Subscribe lead to a list | Email, List Name |
| **Remove Lead from List** | Unsubscribe lead from a list | Email, List Name |
| **Add Tag** | Assign a tag to a lead | Email, Tag Name |
| **Remove Tag** | Remove a tag from a lead | Email, Tag Name |
| **Add Lead to Sequence** | Subscribe lead to an email sequence | Email, Sequence Name |
| **Remove Lead from Sequence** | Unsubscribe lead from a sequence | Email, Sequence Name |
| **Add Points to Lead** | Give points to a lead (lead scoring) | Email, Points |
| **Remove Points from Lead** | Remove points from a lead | Email, Points |
| **Add Lead to Calendar** | Subscribe lead to a calendar | Email, Calendar Name |
| **Remove Lead from Calendar** | Cancel calendar subscription | Email, Calendar Name |

### Resource: Transaction

| Operation | Description | Required Fields |
|-----------|-------------|----------------|
| **Get Lead's Transactions** | Get all transactions for a lead | Email |
| **Get Lead's Subscriptions** | Get all recurring subscriptions for a lead | Email |
| **Search Transaction** | Check if a transaction exists | Transaction ID |
| **Get Transaction Details** | Get details of a specific transaction | Transaction ID |

### Resource: Generic

| Operation | Description | Required Fields |
|-----------|-------------|----------------|
| **Make an API Call** | Execute any Kartra API command | Command |

---

## Trigger Setup

The **Kartra Trigger** node receives real-time events from Kartra via webhook.

### Supported Events

| Event | Description |
|-------|-------------|
| `tag_assigned` | A tag was assigned to a lead |
| `tag_unassigned` | A tag was removed from a lead |
| `list_subscription` | A lead subscribed to a list |
| `list_unsubscription` | A lead unsubscribed from a list |
| `sequence_subscription` | A lead was added to a sequence |
| `sequence_unsubscription` | A lead was removed from a sequence |
| `lead_optin` | A lead opted in |
| `lead_purchase` | A lead made a purchase |
| `lead_refund` | A purchase was refunded |
| `membership_access_granted` | A lead gained membership access |
| `membership_access_revoked` | Membership access was revoked |
| `calendar_subscription` | A lead subscribed to a calendar |

### How to Configure in Kartra

1. Add the **Kartra Trigger** node to your n8n workflow
2. Activate the workflow — n8n will show you the **webhook URL**
3. In Kartra: Go to **Settings → My Integrations → Outbound API**
4. Create a new Outbound API connection:
   - **Endpoint URL**: paste the n8n webhook URL
   - **Method**: POST
   - Select the events you want to send
5. Save and test with a real event

---

## 👨‍💻 Built by Ivan Lao — Marketing Automation Specialist

This node was built by **[Ivan Lao](https://laoivan.com)**, a Marketing Automation
consultant with 10+ years of experience, certified Make Service Partner, and n8n
expert based in Florence, Italy.

| | |
|---|---|
| 🌐 **Website** | [laoivan.com](https://laoivan.com) |
| 💼 **LinkedIn** | [@ivanlaomarketing](https://linkedin.com/in/ivanlaomarketing) |
| 📺 **YouTube** | [@IvanLaoMarketing](https://youtube.com/@IvanLaoMarketing) |
| 📸 **Instagram** | [@ivanlaomarketing](https://instagram.com/ivanlaomarketing) |
| 💬 **WhatsApp Channel** | [Join here](https://whatsapp.com/channel/0029Va8yswJE50UcnzgnGn02) |
| 📣 **Telegram** | [@IvanLaoMarketingAutomation](https://t.me/IvanLaoMarketingAutomation) |
| 👥 **Facebook Group** | [Make Italia](https://facebook.com/groups/makeitalia) |

> 💡 Need help with automation? Contact: **info@laoivan.com**

---

## Contributing

Contributions are welcome! Please open an issue or pull request on
[GitHub](https://github.com/ivanlaomarketing/n8n-nodes-kartra).

For bugs and feature requests: [GitHub Issues](https://github.com/ivanlaomarketing/n8n-nodes-kartra/issues)

---

## License

[MIT](LICENSE) © 2026 [Ivan Lao](https://laoivan.com)