Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to ChartMogul

Scalekit connector
Open markdown

The ChartMogul connector lets your AI agent act in each user's ChartMogul account. Each user connects their own ChartMogul API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
34 · 20 · 634 read20 write6 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the ChartMogul connection

    In AgentKit > Connections, create a ChartMogul connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • chartmogul_account_getGet details of the ChartMogul account the API key belongs to.Read-only

    Get Account

    Get details of the ChartMogul account the API key belongs to. Returns the account name, currency, time zone and week start, plus any extra settings requested. Use chartmogul_account_get to check the connection and the account currency.

    Inputs

    includestring
    Comma-separated extra settings to include: churn_recognition, churn_when_zero_mrr, auto_churn_subscription, refund_handling, proximate_movement_reclassification. Example: churn_recognition,refund_handling
  • chartmogul_activities_listList MRR activities across all customers (new business, reactivation, expansion, contraction, churn) for a period.Read-only

    List Activities

    List MRR activities across all customers (new business, reactivation, expansion, contraction, churn) for a period. Returns a page of activities with customer, date, type, MRR change and a cursor. Use chartmogul_activities_list to see what drove MRR changes. Use chartmogul_customer_activities_list for one customer.

    Inputs

    cursorstring
    Cursor from the previous page's response to fetch the next page; leave empty for the first page. Example: MjAyMy0wNi0wOVQxMzoxNjowMC4wMDBa
    end_datestring
    Only activities on or before this ISO 8601 time. Example: 2026-10-31
    orderstring
    date (oldest first, default) or -date (newest first). One of: date, -date. Example: -dateone of date-date
    per_pageinteger
    Results per page, at most 200 (the default). Example: 50
    start_datestring
    Only activities on or after this ISO 8601 time. Example: 2026-10-01
    typestring
    Only this activity type. One of: new_biz, reactivation, expansion, contraction, churn. Example: churnone of new_bizreactivationexpansioncontractionchurn
  • chartmogul_contact_getGet one contact by UUID.Read-only

    Get Contact

    Get one contact by UUID. Returns the contact's name, email, phone, position, customer and custom attributes. Use chartmogul_contact_get when you know the UUID. Use chartmogul_contacts_list to find it.

    Inputs

    contact_uuidstringrequired
    ChartMogul contact UUID (con_...), from chartmogul_contacts_list. Example: con_00000000-0000-0000-0000-000000000000
    attributes_with_historystring
    Comma-separated contact fields to include edit history for, such as email or title. Example: email,title
    with_overridesboolean
    Include the contact's overridden fields. Example: false
  • chartmogul_contacts_listList contacts, optionally for one customer, source or email.Read-only

    List Contacts

    List contacts, optionally for one customer, source or email. Returns a page of contacts and a cursor for the next page. Use chartmogul_contacts_list to find contacts. Use chartmogul_contact_get for one.

    Inputs

    cursorstring
    Cursor from the previous page's response to fetch the next page; leave empty for the first page. Example: MjAyMy0wNi0wOVQxMzoxNjowMC4wMDBa
    customer_external_idstring
    Only contacts of the customer with this external ID. Example: cus_0001
    customer_uuidstring
    Only contacts of this customer. Example: cus_de305d54-75b4-431b-adb2-eb6b9e546012
    data_source_uuidstring
    Only contacts in this source. Example: ds_fef05d54-47b4-431b-aed2-eb6b9e545430
    emailstring
    Only contacts with this email. Example: jane@example.com
    per_pageinteger
    Results per page, at most 200 (the default). Example: 50
  • chartmogul_customer_activities_listList a customer's MRR activities (new business, expansion, contraction, churn, reactivation).Read-only

    List Customer Activities

    List a customer's MRR activities (new business, expansion, contraction, churn, reactivation). Returns a page of activities with date, type, MRR change and description. Use chartmogul_customer_activities_list for one customer. Use chartmogul_activities_list across all customers.

    Inputs

    customer_uuidstringrequired
    ChartMogul customer UUID (cus_...), from chartmogul_customers_list. Example: cus_de305d54-75b4-431b-adb2-eb6b9e546012
    cursorstring
    Cursor from the previous page's response to fetch the next page; leave empty for the first page. Example: MjAyMy0wNi0wOVQxMzoxNjowMC4wMDBa
    per_pageinteger
    Results per page, at most 200 (the default). Example: 50
  • chartmogul_customer_attributes_getGet a customer's tags, custom attributes and billing-system metadata.Read-only

    Get Customer Attributes

    Get a customer's tags, custom attributes and billing-system metadata. Returns the attributes object, and optionally overrides and edit history. Use chartmogul_customer_attributes_get to read custom attributes. Use chartmogul_customer_get for the full customer.

    Inputs

    customer_uuidstringrequired
    ChartMogul customer UUID (cus_...), from chartmogul_customers_list. Example: cus_de305d54-75b4-431b-adb2-eb6b9e546012
    attributes_with_historystring
    Comma-separated custom attribute names (for example custom.channel) to include edit history for. Example: custom.channel
    with_overridesboolean
    Include overrides on custom attributes. Example: false
  • chartmogul_customer_getGet one customer by UUID.Read-only

    Get Customer

    Get one customer by UUID. Returns the customer's details, status, MRR, ARR, address, tags and custom attributes, and optionally overrides and attribute history. Use chartmogul_customer_get when you know the UUID. Use chartmogul_customers_list or chartmogul_customers_search_by_email to find it.

    Inputs

    customer_uuidstringrequired
    ChartMogul customer UUID (cus_...), from chartmogul_customers_list. Example: cus_de305d54-75b4-431b-adb2-eb6b9e546012
    attributes_with_historystring
    Comma-separated attribute names to include edit history for, such as company, owner, status, address or custom.channel. Example: company,owner
    with_overridesboolean
    Include an overrides object flagging the customer's overridden fields. Example: false
  • chartmogul_customer_invoices_listList the invoices imported through the API for one customer.Read-only

    List Customer Invoices

    List the invoices imported through the API for one customer. Returns a page of invoices with line items and transactions. Use chartmogul_customer_invoices_list for one customer. Use chartmogul_invoices_list across the account.

    Inputs

    customer_uuidstringrequired
    ChartMogul customer UUID (cus_...), from chartmogul_customers_list. Example: cus_de305d54-75b4-431b-adb2-eb6b9e546012
    cursorstring
    Cursor from the previous page's response to fetch the next page; leave empty for the first page. Example: MjAyMy0wNi0wOVQxMzoxNjowMC4wMDBa
    per_pageinteger
    Results per page, at most 200 (the default). Example: 50
    validation_typestring
    valid (default), invalid or all. One of: valid, invalid, all. Example: validone of validinvalidall