n8n-nodes-kartra

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

📦 npm • 💻 GitHub • 📖 Docs • 🌐 laoivan.com

Description

This n8n community node provides full integration with Kartra, 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)

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, a Marketing Automation consultant with 10+ years of experience, certified Make Service Partner, and n8n expert based in Florence, Italy.

| | | |---|---| | 🌐 Website | laoivan.com | | 💼 LinkedIn | @ivanlaomarketing | | 📺 YouTube | @IvanLaoMarketing | | 📸 Instagram | @ivanlaomarketing | | 💬 WhatsApp Channel | Join here | | 📣 Telegram | @IvanLaoMarketingAutomation | | 👥 Facebook Group | Make Italia |

💡 Need help with automation? Contact: [email protected]

Contributing

Contributions are welcome! Please open an issue or pull request on GitHub.

For bugs and feature requests: GitHub Issues

License

MIT © 2026 Ivan Lao