Description

n8n-nodes-chartmogul

This is an n8n community node. It lets you interact with the ChartMogul API in your n8n workflows.

ChartMogul is a subscription analytics platform that helps SaaS (Software-as-a-Service) and recurring revenue businesses understand, measure, and grow their revenue. ChartMogul CRM is a customer relationship management platform built specifically for B2B SaaS companies that unifies sales pipeline tracking with subscription analytics, enabling teams to manage leads, opportunities, and recurring revenue in a single integrated system.

n8n is a fair-code licensed workflow automation platform.

• Installation
• Operations
• Credentials
• Compatibility
• Resources
• Version history

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes.
2. Select Install.
3. Enter n8n-nodes-chartmogul in Enter npm package name.
4. Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source.
5. Select Install.

After installing the node, you can use it like any other node. n8n displays the node in search results in the Nodes panel.

Operations

As of v3, the node provides full coverage of the publicly documented ChartMogul API (dev.chartmogul.com), grouped into the resources below. Each resource exposes its standard create / retrieve / list / update / delete operations where the API supports them.

CRM

• Account — Get account details
• Customer — Create, Retrieve, List, List by email, Update, Delete, Merge, Unmerge, Add a contact, List a customer’s activities, List a customer’s invoices
• Contact — Create, Retrieve, List, Update, Delete
• Enrichment — Add/remove custom attributes (by UUID or email), Add/remove tags (by UUID or email), Retrieve tags and attributes
• Note and Call Log — Create, Retrieve, List, Update, Delete
• Opportunity — Create, Retrieve, List, Update, Delete
• Task — Create, Retrieve, List, Update, Delete
• Activity — List activities, Create an activities export, Retrieve an activities export

Subscription & billing data

• Source — Create, Retrieve, List, Delete
• Plan — Create, Retrieve, List, Update, Delete
• Plan Group — Create, Retrieve, List, Update, Delete, List plans in a group
• Customer Subscription — List, Connect, Disconnect
• Invoice — Create, Retrieve, List, Update, Update status, Disable, Delete, Delete all of a customer
• Line Item — Create, Retrieve, Update, Disable, Delete
• Transaction — Create, Retrieve, Update, Disable, Delete
• Subscription Event — Create, List, Update, Disable, Delete

Metrics

• Metric — All key metrics, MRR, ARR, ARPA, ASP, Customer count, Customer churn rate, MRR churn rate, LTV

List operations support Return All (auto-paginates through every page) or a Limit to cap results.

Credentials

You need to have a ChartMogul account to interact with this node.

In ChartMogul, create an API key by navigating to Profile > View Profile > API keys. Then:
1. Click Add API Key.
2. Enter a unique name for the key in the Name field.
3. A Read & Write key is required for this node.
4. Click Add to create the key.
5. Copy your newly created key and create a ChartMogul credential in N8N


Compatibility

This node was developed and tested using N8N version 1.116.2.

Resources

• n8n community nodes documentation
• ChartMogul Help Center
• ChartMogul Developer Reference

Versioning

This node implements n8n’s versioning system to support future updates while maintaining backwards compatibility. The current node version is v3.

For detailed information about the versioning structure and how to add new versions, see VERSIONING.md.

Version history

v3.0.0 (Current)

• Rewritten as a declarative node for faster, more maintainable API coverage
• Full coverage of the documented ChartMogul API across all resources (Account, Activity, Contact, Customer, Enrichment, Note and Call Log, Opportunity, Task, Source, Plan, Plan Group, Customer Subscription, Invoice, Line Item, Transaction, Subscription Event, Metrics)
• Cursor-based pagination on list operations via Return All / Limit
• Published as a verified community node via GitHub Actions with npm provenance
• Breaking: operation and parameter names were reorganized — workflows built on v1 may need to be updated

v1.0.4

• Implemented full versioning structure
• Reorganized codebase with v1 directory for future version support

v1.0.0

• Initial Release