---
title: "SetBillingAddress"
method: POST
path: "/gitpod.v1.BillingService/SetBillingAddress"
tags: ["gitpod.v1.BillingService"]
---

# SetBillingAddress

`POST /gitpod.v1.BillingService/SetBillingAddress`

Sets or updates the billing address for an organization.

 Use this method to:
 - Set billing address for tax calculation and compliance
 - Update existing billing address information
 - Support international billing requirements

 ### Examples

 - Set billing address:

   Sets a complete billing address for the organization.

   ```yaml
   organizationId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
   name: "John Doe"
   address:
     line1: "123 Main St"
     line2: "Suite 100"
     city: "San Francisco"
     state: "CA"
     postalCode: "94105"
     country: "US"
   ```

## Request body

- GitpodV1SetBillingAddressRequest
  - `address` GitpodV1BillingAddress, required — BillingAddress represents a billing address for an organization
    - `city` string, required — city is the city name
    - `country` string, required — country is the two-letter country code (ISO 3166-1 alpha-2)
    - `line1` string, required — line1 is the first line of the address (street address)
    - `line2` string — line2 is the second line of the address (apartment, suite, etc.)
    - `postalCode` string, required — postal_code is the postal or ZIP code
    - `state` string — state is the state or province
  - `name` string, required — name is the name associated with the billing address
  - `organizationId` string, uuid, required — organization_id is the ID of the organization to set billing address for

## Response `200`

Success

- GitpodV1SetBillingAddressResponse

## Other responses

- `default` — Error

---

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