Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to ProAbono

Scalekit connector
Open markdown

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

Tools
41
What they doRead · write · destructive
22 · 15 · 422 read15 write4 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 ProAbono connection

    In AgentKit > Connections, create a ProAbono 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
  • proabono_balance_line_quotePreview the effect of adding a balance line (one-off charge or credit) to a customer.Read-only

    Quote Balance Line

    Preview the effect of adding a balance line (one-off charge or credit) to a customer. Use proabono_balance_line_create to add it.

    Inputs

    reference_customerstringrequired
    Your own unique reference for the customer (the ReferenceCustomer you set when creating it). Example: cust-42
    amountinteger
    Amount in cents, before taxes. Example: 50000
    ensure_billableboolean
    Require payment info. Example: true
    htmlboolean
    HTML amounts. Example: true
    id_customerinteger
    Customer ID. Example: 133700
    id_subscriptioninteger
    ProAbono subscription ID (integer). Get it from proabono_subscriptions_list or proabono_subscription_get_by_customer. Example: 10725
    labelstring
    Invoice line label. Example: Consulting (hours)
    quantityinteger
    Informative quantity. Example: 18
  • proabono_balance_lines_listList balance lines by segment, feature, customer or subscription; the total is in Computations.Read-only

    List Balance Lines

    List balance lines by segment, feature, customer or subscription; the total is in Computations. Set size_page 0 to get only the total.

    Inputs

    id_customerinteger
    Customer ID. Example: 133700
    id_subscriptioninteger
    ProAbono subscription ID (integer). Get it from proabono_subscriptions_list or proabono_subscription_get_by_customer. Example: 10725
    pageinteger
    Page number, starting at 1. Example: 1
    reference_customerstring
    Your own unique reference for the customer (the ReferenceCustomer you set when creating it). Example: cust-42
    reference_featurestring
    Feature. Example: feat-users
    reference_segmentstring
    Segment. Example: demo-eur
    size_pageinteger
    Number of records per page. Example: 20
  • proabono_billing_address_getGet a customer's billing address.Read-only

    Get Billing Address

    Get a customer's billing address. Use the ReferenceCustomer you set when creating the customer with proabono_customer_upsert.

    Inputs

    reference_customerstringrequired
    Your own unique reference for the customer (the ReferenceCustomer you set when creating it). Example: cust-42
  • proabono_customer_getGet a customer by its ReferenceCustomer, with its status and hosted portal links.Read-only

    Get Customer

    Get a customer by its ReferenceCustomer, with its status and hosted portal links. Use the ReferenceCustomer you set when creating the customer with proabono_customer_upsert.

    Inputs

    reference_customerstringrequired
    Your own unique reference for the customer (the ReferenceCustomer you set when creating it). Example: cust-42
    reference_offerstring
    Offer for a subscribe link. Example: offer-premium
  • proabono_customers_listList customers, optionally by segment or by a feature in their active subscriptions, with paging.Read-only

    List Customers

    List customers, optionally by segment or by a feature in their active subscriptions, with paging. Use proabono_customer_get for one customer.

    Inputs

    pageinteger
    Page number, starting at 1. Example: 1
    reference_featurestring
    Only customers with an active subscription containing this feature. Example: feat-users
    reference_segmentstring
    Segment reference. Example: demo-eur
    size_pageinteger
    Number of records per page. Example: 20
  • proabono_feature_getGet one feature by its reference.Read-only

    Get Feature

    Get one feature by its reference. Get feature references from proabono_features_list.

    Inputs

    reference_featurestringrequired
    Feature reference. Example: feat-users
    languagestring
    Language code: de, en, es, fr, nl, pt or it. One of: de, en, es, fr, nl, pt, it. Example: enone of deenesfrnlptit
    reference_customerstring
    Your own unique reference for the customer (the ReferenceCustomer you set when creating it). Example: cust-42
    reference_segmentstring
    Segment reference. Example: demo-eur
  • proabono_features_listList the features defined in a segment.Read-only

    List Features

    List the features defined in a segment. Use proabono_feature_get for one feature.

    Inputs

    is_visibleboolean
    Visible only. Example: true
    languagestring
    Language code: de, en, es, fr, nl, pt or it. One of: de, en, es, fr, nl, pt, it. Example: enone of deenesfrnlptit
    pageinteger
    Page number, starting at 1. Example: 1
    reference_customerstring
    Your own unique reference for the customer (the ReferenceCustomer you set when creating it). Example: cust-42
    reference_segmentstring
    Segment reference. Example: demo-eur
    size_pageinteger
    Number of records per page. Example: 20
  • proabono_invoice_getGet one invoice by ID with lines, totals and status.Read-only

    Get Invoice

    Get one invoice by ID with lines, totals and status. Get invoice IDs from proabono_invoices_list.

    Inputs

    id_invoiceintegerrequired
    Invoice ID. Example: 549013