---
title: "Update Billing Preference"
method: PUT
path: "/v0/teams/me/billing_preference"
tags: ["teams"]
---

# Update Billing Preference

`PUT /v0/teams/me/billing_preference`

## Query parameters

- `retry` integer

## Request body

- TeamBillingPreferenceUpdate
  - `collection_method` string
  - `billing_email` string, email, required
  - `send_to_billing_email` boolean, required
  - `send_to_other_recipients` boolean, required
  - `other_recipients` string[]
  - `bill_to_name_source` 'company' | 'custom', required
  - `custom_bill_to_name` string, nullable
  - `invoice_address_source` 'contact' | 'custom', required
  - `custom_billing_address` TeamBillingAddressUpdate
    - `address_line1` string, required
    - `city` string, required
    - `state_province_region` string, required
    - `country_region` string, required
    - `postal_code` string, required
    - `address_line2` string, nullable
    - `phone_cc` string, nullable
    - `phone_num` string, nullable
  - `tax_id` TeamTaxID
    - `tax_id_types` string, required
    - `country` string, required
    - `value` string, required
    - `status` string

## Response `200`

Successful Response

- TeamBillingPreferenceDetailView
  - `collection_method` string, required
  - `send_to_owner` boolean, required
  - `owner_emails` string[]
  - `send_to_admin` boolean, required
  - `admin_emails` string[]
  - `send_to_accountant` boolean, required
  - `accountant_emails` string[]
  - `other_recipients` string[]
  - `recipient_count` integer, required
  - `billing_address` TeamContactView
    - `address_line1` string, required
    - `city` string, required
    - `state_province_region` string, required
    - `country_region` string, required
    - `postal_code` string, required
    - `phone_cc` string, required
    - `phone_num` string, required
    - `address_type` 'Business' | 'Billing', required
    - `company_name` string, nullable
    - `address_line2` string, nullable
  - `tax_id` TeamTaxID
    - `tax_id_types` string, required
    - `country` string, required
    - `value` string, required
    - `status` string
  - `billing_email` string, nullable
  - `send_to_billing_email` boolean, required
  - `send_to_other_recipients` boolean, required
  - `bill_to_name_source` 'company' | 'custom', required
  - `company_name` string, nullable
  - `custom_bill_to_name` string, nullable
  - `invoice_address_source` 'contact' | 'custom', required
  - `contact_address` TeamContactView
    - `address_line1` string, required
    - `city` string, required
    - `state_province_region` string, required
    - `country_region` string, required
    - `postal_code` string, required
    - `phone_cc` string, required
    - `phone_num` string, required
    - `address_type` 'Business' | 'Billing', required
    - `company_name` string, nullable
    - `address_line2` string, nullable
  - `custom_billing_address` TeamContactView
    - `address_line1` string, required
    - `city` string, required
    - `state_province_region` string, required
    - `country_region` string, required
    - `postal_code` string, required
    - `phone_cc` string, required
    - `phone_num` string, required
    - `address_type` 'Business' | 'Billing', required
    - `company_name` string, nullable
    - `address_line2` string, nullable

## Other responses

- `401` — If user authentication fails
- `403` — If user does not have sufficient permissions
- `422` — Validation Error

---

[API](https://skmtc.net/databento/apis/databento-openapi-specification.md) · [All operations](https://skmtc.net/databento/apis/databento-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/databento/databento-openapi-specification/revisions/08ef3d01f5b8/schema)