Contacts::BillingAddress

Create contact billing address

Changed on

Create the contact's billing address, also shown in the contact overview. The contact in the URL owns the address. A second create returns 422; use PATCH on this URL to change it. Saving syncs Stripe customers and billing details on non-terminal Stripe orders. Checkout billing prefill comes from payment methods.

post/contacts/{contact_id}/billing_address

Request

Path parameters

contact_idstring required

Request body

Example request

{
  "contacts_billing_address": {
    "address_one": "3443 W. Bavaria St.",
    "address_two": "Suite 100",
    "city": "Eagle",
    "region": "ID",
    "country_code": "US",
    "postal_code": "83616"
  }
}

Response

Created

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