View as Markdown
Pennylane icon

Pennylane ACTION

Create Customer

Creates a new customer in Pennylane. 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 Customer 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-customer",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pennylane: { authProvisionId: "apn_xxxxxxx" },
    customerType: "Customer Type",
    firstName: "First Name",
  },
})

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 Customer inputs
Property Type Description
customerType Customer Type string
The type of the customer you want to create.
Required
firstName First Name string
Customer first name.
Required
lastName Last Name string
Customer last name.
Required
gender Gender string
Customer Gender
Optional
name Name string
The name of the company.
Required
regNo Reg No string
Customer registration number (SIREN).
Optional
address Address string
Customer address (billing address).
Required
postalCode Postal Code string
Postal code (billing address).
Required
city City string
City (billing address).
Required
country Country string
Any ISO 3166 Alpha-2 country code (billing address).
Required
recipient Recipient string
Recipient displayed in the invoice.
Optional
vatNumber VAT Number string
Customer's VAT number.
Optional
sourceId Source Id string
You can use your own id when creating the customer. If not provided, Pennylane will pick one for you. Id must be unique.
Optional
emails Emails string[]
A list of customer emails.
Optional
billingIban Billing IBAN string
The billing IBAN of the customer. This is the iban on which you wish to receive payment from this customer.
Optional
deliveryAddress Delivery Address string
Address (shipping address).
Optional
deliveryPostalCode Delivery Postal Code string
Postal code (shipping address).
Optional
deliveryCity Delivery City string
City (shipping address).
Optional
deliveryCountry Delivery Country string
Any ISO 3166 Alpha-2 country code (shipping address).
Optional
paymentConditions Payment Conditions string
Customer payment conditions
Optional
phone Phone string
Customer phone number.
Optional
reference Reference string
This reference doesn't appear on the invoice.
Optional
notes Notes string
Notes about the customer.
Optional
mandate Mandate object
The mandate object. Example: {"provider": "gocardless","source_id": "MD001H23WP8E7XN"}.
Optional
planItem Plan Item object
The plan item object. Example: {"enabled": true,"number": "123","label": "label","vat_rate": "123","country_alpha2": "US","description": "description"}.
Optional

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-customer
Version
0.0.3
App
Pennylane
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes