---
title: "Create Billing Address"
method: POST
path: "/v1/billing/addresses"
tags: ["Billing"]
---

# Create Billing Address

`POST /v1/billing/addresses`

Add a new address which can be associated with a payment method

## Request body

- CreateBillingAddressRequest
  - `first_name` string, required — First name of the billing contact
  - `last_name` string, required — Last name of the billing contact
  - `address_line_1` string, required — First Address line of the billing contact
  - `address_line_2` string — Second Address line of the billing contact
  - `company_name` string — Company name of the billing contact
  - `email` string, required — Email address of the billing contact
  - `city` string, required — City of the billing contact
  - `state` string, required — State / Province of the billing contact
  - `country` string, required — Country Code of the billing contact
  - `postal_code` string, required — Postal code of the billing contact
  - `telephone` string, required — Telephone number of the billing contact
  - `receive_invoice_emails` boolean — Setting to true will CC this email address on invoice emails

## Response `200`

OK

- CreateBillingAddressResponse
  - `success` boolean — whether the request succeeded
  - `errors` string[]
  - `messages` string[], nullable
  - `result` BillingAddress — Address associated with a credit card or billing contact
    - `id` integer — Billing address identifier
    - `first_name` string — First name of the billing contact
    - `last_name` string — Last name of the billing contact
    - `address_line_1` string — First Address line of the billing contact
    - `address_line_2` string — Second Address line of the billing contact
    - `company_name` string — Company name of the billing contact
    - `email` string — Email address of the billing contact
    - `city` string — City of the billing contact
    - `state` string — State / Province of the billing contact
    - `country` string — Country Code of the billing contact
    - `postal_code` string — Postal code of the billing contact
    - `telephone` string — Telephone number of the billing contact
    - `receive_invoice_emails` boolean — If this email address should receive invoice related emails

## Other responses

- `400` — Bad Request
- `401` — Authentication failed
- `403` — Not authorized to access endpoint
- `405` — Invalid input
- `500` — Internal error

---

[API](https://skmtc.net/rocket/apis/rocket-net-api.md) · [All operations](https://skmtc.net/rocket/apis/rocket-net-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rocket/rocket-net-api/versions/db0dcbbc5764/schema)