Contacts::BillingAddress

Update contact billing address

Changed on

Partially update the contact's existing billing address in place. Returns 404 if none is set. Changes sync Stripe customers and billing details on non-terminal Stripe orders. This does not replace a payment method's billing address or control checkout billing prefill.

patch/contacts/{contact_id}/billing_address

Request

Path parameters

contact_idstring required

Request body

Example request

{
  "contacts_billing_address": {
    "postal_code": "83617"
  }
}

Response

OK

idinteger

Postal address row ID

public_idstring

Postal address public ID

address_onestring nullable

Address one

address_twostring nullable

Address two

citystring nullable

City

regionstring nullable

State or region code

region_namestring nullable

Full region name

countrystring nullable

ISO2 country code

postal_codestring nullable

Postal code

created_atstring date-time

Created at

updated_atstring date-time

Updated at

contact_idinteger

ID of the contact whose billing address this is

Example response

{
  "id": 9002,
  "public_id": "bNcMdL",
  "contact_id": 123,
  "address_one": "3443 W. Bavaria St.",
  "address_two": "Suite 100",
  "city": "Eagle",
  "region": "ID",
  "region_name": "Idaho",
  "country": "US",
  "postal_code": "83616",
  "created_at": "2026-10-01T10:00:00Z",
  "updated_at": "2026-10-01T10:00:00Z"
}

Changes