Update billing details

PATCH

/customers/{id}/billing

Update a customer's billing details.

Request

Authorization

API Key

Add parameter in header

rs-x-api-key

Example:

rs-x-api-key: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200

application/json

Billing details updated

Bodyapplication/json

🟠401

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/customers//billing' \
--header 'rs-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "firstName": "Jane",
    "lastName": "Doe",
    "company": "Acme Corp",
    "addressLineOne": "123 Market St",
    "addressLineTwo": "Suite 400",
    "addressLineThree": "Attn: Accounts Payable",
    "city": "San Francisco",
    "state": "CA",
    "country": "US",
    "postalCode": "94103",
    "phoneCc": "+1",
    "phone": "5551234567",
    "languagePreference": "en"
}'

Response Example

{
    "status": 200,
    "message": "Customer",
    "data": {
        "id": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e",
        "componentUserId": "USR-7K2M9QX4",
        "partnerId": "1f2e3d4c-5b6a-4978-8899-aabbccddeeff",
        "firstName": "Jane",
        "lastName": "Doe",
        "email": "jane.doe@acme.com",
        "stripeCustomerId": "cus_QabcXYZ123",
        "notes": "VIP account, prefers email contact",
        "tags": [
            "vip",
            "reseller"
        ],
        "status": "ACTIVE",
        "createdAt": "2026-06-10T14:22:00.000Z",
        "workspaces": [
            {
                "userId": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e",
                "id": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
                "name": "Acme Corp",
                "isPrimary": true,
                "createdAt": "2026-06-10T14:22:00.000Z",
                "billingRecords": [
                    {
                        "firstName": "Jane",
                        "lastName": "Doe",
                        "company": "Acme Corp",
                        "addressLineOne": "123 Market St",
                        "addressLineTwo": "Suite 400",
                        "addressLineThree": null,
                        "city": "San Francisco",
                        "state": "CA",
                        "country": "US",
                        "postalCode": "94103",
                        "phoneCc": "+1",
                        "phone": "5551234567",
                        "languagePreference": "en"
                    }
                ]
            }
        ],
        "mailboxesPurchased": 3,
        "domainsPurchased": 5,
        "netProfit": 24.5,
        "totalRevenue": 89.95,
        "health": "good",
        "hasSavedCard": true
    }
}

Modified at 2026-08-28 11:33:21

Update customer status

List countries