View as Markdown
Pennylane icon

Pennylane ACTION

Create Billing Subscription

Creates a billing subscription for a customer. See the documentation.
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Pennylane account once, then configure and run Create Billing Subscription from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "pennylane-create-billing-subscription",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pennylane: { authProvisionId: "apn_xxxxxxx" },
    currency: "Currency",
    mode: "Mode",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Billing Subscription inputs
Property Type Description
currency Currency string
Invoice Currency (ISO 4217). Default is EUR.
Optional
mode Mode string
Mode in which the new invoices will be created.
Required
start Start string
Start date (ISO 8601)
Required
paymentConditions Payment Conditions string
Customer payment conditions
Required
paymentMethod Payment Method string
PaymentMethod
Required
recurringRuleType Recurring Rule Type string
Type of the billing subscription's recurrence
Required
dayOfMonth Day Of Month integer
The day of occurrences of the recurring rule
Required
dayOfWeek Day Of Week string
The day of occurrences of the recurring rule
Required
interval Interval string
The interval of occurrences of the recurring rule
Optional
count Count integer
Number of occurrences of the recurring rule
Optional
specialMention Special Mention string
Additional details
Optional
discount Discount integer
Invoice discount (in percent)
Optional
customerId Customer Id string
Existing customer identifier (source_id)
Required Dynamic
lineItemsSectionsAttributes Line Items Sections Attributes string[]
A list of objects of items sections to be listed on the invoice. Example: [{"title": "Title","description": "description","rank": 1}] See the documentation from further information.
Optional
invoiceLines Invoice Lines string[]
A list of objects of items to be listed on the invoice. Example: [{"product": {"source_id": "0e67fc3c-c632-4feb-ad34-e18ed5fbf66a","unit": "20","price": "10.00","label": "Product label","vat_rate": "FR_09","currency": "EUR"},"quantity": 2,"label": "Line Item Label"}] See the documentation from further information.
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
pennylane-create-billing-subscription
Version
0.0.3
App
Pennylane
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes