Package Information
Documentation
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)
- Open n8n Settings → Community Nodes
- Click Install
- Enter:
@ivanlaomarketing/n8n-nodes-kartra - 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
- Add a Kartra node to your workflow
- Click on Credentials → Create New
- Fill in API Key, API Password, and App ID
- Click Save
Operations Reference
Resource: Lead
| Operation | Description | Required Fields |
|---|---|---|
| Create Lead | Create a new lead in Kartra | |
| Create Lead (Advanced) | Create a lead with all fields + custom fields | |
| Update Lead | Update an existing lead | Email or Lead ID |
| Get Lead | Get full lead profile (tags, lists, transactions...) | |
| 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 | |
| Get Lead's Subscriptions | Get all recurring subscriptions for a lead | |
| 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
- Add the Kartra Trigger node to your n8n workflow
- Activate the workflow — n8n will show you the webhook URL
- In Kartra: Go to Settings → My Integrations → Outbound API
- Create a new Outbound API connection:
- Endpoint URL: paste the n8n webhook URL
- Method: POST
- Select the events you want to send
- 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 |
| @ivanlaomarketing | |
| 📺 YouTube | @IvanLaoMarketing |
| @ivanlaomarketing | |
| 💬 WhatsApp Channel | Join here |
| 📣 Telegram | @IvanLaoMarketingAutomation |
| 👥 Facebook Group | Make Italia |
💡 Need help with automation? Contact: info@laoivan.com
Contributing
Contributions are welcome! Please open an issue or pull request on
GitHub.
For bugs and feature requests: GitHub Issues