Drippay

Drippay Customers API

Create and manage billable customers.

Documentation GitHub OpenAPI

Operations 17

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/customers Create a customer · Create a customer #

Ask an LLM

“What's the minimum I need to send to register a new billing customer?”

“Can I create a customer using my own user ID and add a wallet address later?”

Tell an agent

Create a customer for my user {externalCustomerId}.

Add a new customer {externalCustomerId} with email {email}.

GET /v1/customers List customers · List customers #

Ask an LLM

“How do I list all the customers on my Drip business account?”

“Can I filter my customer list down to only internal test customers?”

Tell an agent

List my newest customers.

List customers with status {status}, {limit} at a time.

GET /v1/customers/{id} Get a customer · Get a customer #

Ask an LLM

“Can I look up a single customer's record by their Drip ID?”

“What details are stored on one specific customer?”

Tell an agent

Show me customer {id}.

Fetch the customer record for {id}.

PATCH /v1/customers/{id} Update a customer · Update a customer #

Ask an LLM

“Can I change the details on an existing customer?”

“How do I edit a customer record after it has been created?”

Tell an agent

Update customer {id}.

Edit the details saved on customer {id}.

GET /v1/customers/{id}/billing-history View a customer's billing-field change history · Get customer billing-field history #

Ask an LLM

“Can I see every past version of a customer's billing name and email?”

“When did a customer's billing email change, and what was it before?”

Tell an agent

Show the billing-field history for customer {id}.

List every name and email snapshot recorded for customer {id}.

GET /v1/customers/{id}/revops-summary Get a customer's RevOps summary · Get RevOps summary #

Ask an LLM

“What is a customer's lifetime revenue and gross margin?”

“Which reputation band is a customer in, and what's their success rate?”

Tell an agent

Give me the RevOps summary for customer {id}.

Show lifetime revenue, cost and top unit types for customer {id}.

POST /v1/customers/{id}/sync-balance Refresh a customer's on-chain balance · Sync customer balance #

Ask an LLM

“A customer just deposited funds on-chain — how do I get the new balance picked up right away?”

“Can I force a fresh balance read from the chain before I charge someone?”

Tell an agent

Sync the on-chain balance for customer {id} now.

Pull the latest on-chain balance into the snapshot for {id}.

POST /v1/customers/{id}/provision Provision a customer's smart account · Provision smart account #

Ask an LLM

“How do I deploy an ERC-4337 smart account for a customer?”

“Does provisioning a smart account on testnet mint test USDC automatically?”

Tell an agent

Provision a smart account for customer {id}.

Deploy a smart account for {id} and deposit {deposit_amount_usdc} USDC into billing.

PUT /v1/customers/{id}/spending-cap Set a customer spending cap · Set customer spending cap #

Ask an LLM

“Can I limit how much a single customer can be charged per day or per month?”

“What happens to charges once a customer hits their spending cap?”

Tell an agent

Set a {capType} cap of {limitValue} on customer {id}.

Cap customer {id} at {limitValue} as a {capType} limit with auto-block set to {autoBlock}.

GET /v1/customers/{id}/spending-caps List a customer's spending caps · List customer spending caps #

Ask an LLM

“Which spending caps are active on a customer and how close are they to each limit?”

“What alert level has a customer's spending cap last triggered?”

Tell an agent

List the spending caps on customer {id}.

Show current usage against each spending cap for {id}.

DELETE /v1/customers/{id}/spending-caps/{capId} Remove a customer spending cap · Remove customer spending cap #

Ask an LLM

“How do I lift a spending cap I put on a customer?”

“Can I deactivate just one of a customer's spending caps?”

Tell an agent destructive · confirm first

Remove spending cap {capId} from customer {id}.

Deactivate cap {capId} for {id}.

POST /v1/customers/{id}/attach-plan Attach a Drip-managed plan to a customer · Attach a Quickstart-managed plan to a customer #

Ask an LLM

“How do I put a customer on a Drip-managed plan so a Stripe subscription gets created?”

“Does a plan need to be provisioned on Stripe before I can attach it to a customer?”

Tell an agent

Attach plan {planId} to customer {id}.

Subscribe customer {id} to plan {planId} on Stripe, billing {customerEmailOverride}.

POST /v1/customers/{id}/sync-stripe-customer Link a customer to a Stripe customer · Sync a Drip customer to Stripe (create cus_xxx and link) #

Ask an LLM

“How do I create a matching Stripe customer for one of my Drip customers?”

“Is it safe to call the Stripe customer sync twice for the same customer?”

Tell an agent

Create and link a Stripe customer for {id}.

Sync customer {id} to Stripe using integration {integrationId} and email {emailOverride}.

GET /v1/customers/{id}/hierarchy Get a customer's parent and child hierarchy · Get customer hierarchy #

Ask an LLM

“Which parent account does a customer sit under, and who are its sub-customers?”

“Can I see the full account tree above and below a customer?”

Tell an agent

Show the account hierarchy for customer {id}.

List the ancestors and descendants of {id}.

GET /v1/customers/{id}/rollup Get roll-up totals for a customer and its children · Get customer roll-up stats #

Ask an LLM

“What are the combined invoice totals for a parent account including all its sub-customers?”

“Can I see usage rolled up across a customer's whole account tree?”

Tell an agent

Give me the roll-up stats for customer {id} and its descendants.

Total invoices and usage across the account tree under {id}.

GET /v1/customers/{id}/touches List recent touches for a customer · List recent touches for a customer #

Ask an LLM

“What are the latest touches the CLI pushed for a customer?”

“Can I pull more than ten recent touches for one customer?”

Tell an agent

Show the recent touches for customer {id}.

List the last {limit} touches for {id}.

GET /v1/customers/{id}/balance Get a customer's cached balance · Get customer balance #

Ask an LLM

“How much balance does a customer have right now?”

“Is the customer balance I read real-time or a cached snapshot?”

Tell an agent

Check the current balance of customer {id}.

Show the last cached balance for {id}.

Drippay Customers API

Operations 17

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification