patch
https://test-api.bill.pro/api/v2/profiles//customers/
Changes a customer's details. Send only what you want to change. The body has the same fields as Create customer.
What's replaced and what's kept
- A field or block you leave out keeps its current value.
- To clear a text field, such as
phone, send''ornull. A field cleared with''comes back as''. customer_idcan't be empty. If you clear it, BillPro creates a new 10-character ID.organisation,billing_addressandshipping_addresschange only the fields you send.organisation: nullremoves the organisation. If the customer has none yet, sendnametoo.billing_address: nullis ignored. To clear the billing address, send each field as''.shipping_address: nullremoves the shipping address and setssame_as_billing_addresstofalse. Sending ashipping_addresswithoutsame_as_billing_address: truealso sets it tofalse.same_as_billing_address: truecopies the billing address to the shipping address. Anyshipping_addressyou send with it is ignored.- The copy isn't kept in sync. When you change the billing address, send
same_as_billing_address: trueagain, or the shipping address keeps the old copy. tag_listreplaces all the customer's tags. Send[]to remove every tag. Leave it out to keep them. To change only the tags, use Replace customer tags.customer.statuschanges the status. Sendactiveordormant, in lowercase. Other values are ignored without an error, and the status doesn't change.
Existing orders keep the customer details they were created with. Only new orders use the updated details.
The response is the updated customer, without tags.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…