mercury_create_customer
Create a new Accounts Receivable customer to onboard them before issuing invoices. Returns a customer ID required by the invoice creation tool. Check existing customers first to avoid duplicates.
Instructions
Create a new Accounts Receivable customer (a billable entity you will later invoice).
USE WHEN: onboarding a new customer before issuing them an invoice. The returned id is what mercury_create_invoice expects as customerId.
DO NOT USE: for payment recipients (use mercury_add_recipient — different surface, used for outbound bank transfers, not invoicing).
SIDE EFFECTS: writes a new customer to your Mercury workspace. Persistent. NOT idempotent at the API level — calling twice with the same payload creates two customers; check mercury_list_customers for existing entries before creating to avoid duplicates.
RETURNS: { id, name, email, address, ... } — keep id for the invoicing tools.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Customer name | |
| Yes | Customer email | ||
| address | No | Customer billing address (Mercury requires `name` in the address) |