Reference
- Pricing
- Checkout
- Contracts
- Credits
- Customer Dashboards
- Customers
- Entitlements
- Events
- Invoices
- Objects
- One-Time
- Payments
- Metrics
- Subscriptions
Customers
Update Customer
Update a customer by ID or external identifier
PATCH
/
companies
/
{company_id}
/
customers
/
{customer_id}
curl --request PATCH \
--url https://api.maplebilling.com/api/v1/companies/{company_id}/customers/{customer_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"address": {
"address_line_1": "<string>",
"address_line_2": "<string>",
"city": "<string>",
"country": "<string>",
"place_id": "<string>",
"state": "<string>",
"zip": "<string>"
},
"child_rollup_billing": true,
"child_rollup_billing_config": {
"auto_charges": true,
"end_date": "2023-11-07T05:31:56Z",
"frequency": "HOUR",
"invoice_additional_display_fields": [
{
"name": "<string>",
"value": "<string>"
}
],
"invoice_due_date_from_creation": 1,
"start_date": "2023-11-07T05:31:56Z"
},
"email": "<string>",
"exclude_from_metrics": true,
"identifier": "<string>",
"locale": "<string>",
"metadata": {},
"name": "<string>",
"org_name": "<string>",
"override_taxes": [
{
"country": "<string>",
"description": "<string>",
"metadata": {},
"name": "<string>",
"rate": 123,
"region": "<string>",
"type": "GST"
}
],
"owner_id": "<string>",
"parent_customer_id": "<string>",
"phone": "<string>",
"status": "<string>",
"title": "<string>"
}'
{
"address": {
"address_line_1": "<string>",
"address_line_2": "<string>",
"city": "<string>",
"country": "<string>",
"place_id": "<string>",
"state": "<string>",
"zip": "<string>"
},
"arr": {
"currency": "<string>",
"value_in_cents": 123
},
"company_id": "<string>",
"computed_entitlements": [
{
"entitlement_id": "<string>",
"inherited_from_id": "<string>",
"inherited_from_type": "<string>",
"key": "<string>",
"name": "<string>",
"original_value": "<any>",
"overridden": true,
"type": "<string>",
"value": "<any>"
}
],
"created_at": "2023-11-07T05:31:56Z",
"customer_integration_metadata": {},
"email": "<string>",
"exclude_from_metrics": true,
"id": "<string>",
"identifier": "<string>",
"locale": "<string>",
"managed_externally": true,
"metadata": {},
"mrr": {
"currency": "<string>",
"value_in_cents": 123
},
"name": "<string>",
"org_name": "<string>",
"owner_id": "<string>",
"parent_customer_id": "<string>",
"phone": "<string>",
"status": "<string>",
"title": "<string>",
"updated_at": "2023-11-07T05:31:56Z"
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Headers
The idempotency key that will be used to ensure the request is only performed once
Path Parameters
Company ID. It should have a prefix 'cmp_'.
customer_id or identifier
Body
application/json
Response
200 - application/json
OK
The response is of type object
.
curl --request PATCH \
--url https://api.maplebilling.com/api/v1/companies/{company_id}/customers/{customer_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"address": {
"address_line_1": "<string>",
"address_line_2": "<string>",
"city": "<string>",
"country": "<string>",
"place_id": "<string>",
"state": "<string>",
"zip": "<string>"
},
"child_rollup_billing": true,
"child_rollup_billing_config": {
"auto_charges": true,
"end_date": "2023-11-07T05:31:56Z",
"frequency": "HOUR",
"invoice_additional_display_fields": [
{
"name": "<string>",
"value": "<string>"
}
],
"invoice_due_date_from_creation": 1,
"start_date": "2023-11-07T05:31:56Z"
},
"email": "<string>",
"exclude_from_metrics": true,
"identifier": "<string>",
"locale": "<string>",
"metadata": {},
"name": "<string>",
"org_name": "<string>",
"override_taxes": [
{
"country": "<string>",
"description": "<string>",
"metadata": {},
"name": "<string>",
"rate": 123,
"region": "<string>",
"type": "GST"
}
],
"owner_id": "<string>",
"parent_customer_id": "<string>",
"phone": "<string>",
"status": "<string>",
"title": "<string>"
}'
{
"address": {
"address_line_1": "<string>",
"address_line_2": "<string>",
"city": "<string>",
"country": "<string>",
"place_id": "<string>",
"state": "<string>",
"zip": "<string>"
},
"arr": {
"currency": "<string>",
"value_in_cents": 123
},
"company_id": "<string>",
"computed_entitlements": [
{
"entitlement_id": "<string>",
"inherited_from_id": "<string>",
"inherited_from_type": "<string>",
"key": "<string>",
"name": "<string>",
"original_value": "<any>",
"overridden": true,
"type": "<string>",
"value": "<any>"
}
],
"created_at": "2023-11-07T05:31:56Z",
"customer_integration_metadata": {},
"email": "<string>",
"exclude_from_metrics": true,
"id": "<string>",
"identifier": "<string>",
"locale": "<string>",
"managed_externally": true,
"metadata": {},
"mrr": {
"currency": "<string>",
"value_in_cents": 123
},
"name": "<string>",
"org_name": "<string>",
"owner_id": "<string>",
"parent_customer_id": "<string>",
"phone": "<string>",
"status": "<string>",
"title": "<string>",
"updated_at": "2023-11-07T05:31:56Z"
}
Assistant
Responses are generated using AI and may contain mistakes.