--- title: Update Billing Email --- [Skip to content](#%5Ftop) [API Reference](https://developers.cloudflare.com/api/python) [Billing](https://developers.cloudflare.com/api/python/resources/billing) [Profiles](https://developers.cloudflare.com/api/python/resources/billing/subresources/profiles) Copy Markdown Open in **Claude** Open in **ChatGPT** Open in **Cursor** --- **Copy Markdown** **View as Markdown** # Update Billing Email billing.profiles.update\_billing\_email(ProfileUpdateBillingEmailParams\*\*kwargs) \-> [ProfileUpdateBillingEmailResponse](https://developers.cloudflare.com/api/python/resources/billing#%28resource%29%20billing.profiles%20%3E%20%28model%29%20profile%5Fupdate%5Fbilling%5Femail%5Fresponse%20%3E%20%28schema%29) PATCH/accounts/{account\_id}/billing/profile Updates the billing email addresses and preferred locale for an account. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**`X-Auth-Email: user@example.com` The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194` ##### Accepted Permissions (at least one required) `Billing Write` ##### ParametersExpand Collapse account\_id: str Identifier maxLength32 billing\_email: Optional\[str\] preferred\_locale: Optional\[str\] secondary\_billing\_email: Optional\[str\] ##### ReturnsExpand Collapse class ProfileUpdateBillingEmailResponse: … id: Optional\[str\] Billing item identifier tag. maxLength32 account\_type: Optional\[str\] address: Optional\[str\] address2: Optional\[str\] balance: Optional\[str\] card\_expiry\_month: Optional\[int\] card\_expiry\_year: Optional\[int\] card\_number: Optional\[str\] city: Optional\[str\] company: Optional\[str\] country: Optional\[str\] created\_on: Optional\[datetime\] formatdate-time device\_data: Optional\[str\] edited\_on: Optional\[datetime\] formatdate-time enterprise\_billing\_email: Optional\[str\] enterprise\_primary\_email: Optional\[str\] first\_name: Optional\[str\] is\_partner: Optional\[bool\] last\_name: Optional\[str\] next\_bill\_date: Optional\[datetime\] formatdate-time payment\_address: Optional\[str\] payment\_address2: Optional\[str\] payment\_city: Optional\[str\] payment\_country: Optional\[str\] payment\_email: Optional\[str\] payment\_first\_name: Optional\[str\] payment\_gateway: Optional\[str\] payment\_last\_name: Optional\[str\] payment\_nonce: Optional\[str\] payment\_state: Optional\[str\] payment\_zipcode: Optional\[str\] primary\_email: Optional\[str\] state: Optional\[str\] tax\_id\_type: Optional\[str\] telephone: Optional\[str\] validation\_code: Optional\[str\] vat: Optional\[str\] zipcode: Optional\[str\] ### Update Billing Email Python HTTPHTTP TypeScriptTypeScript PythonPython GoGo TerraformTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.billing.profiles.update_billing_email( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(response.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "id": "b69a9f3492637782896352daae219e7d", "account_type": "type", "address": "123 Main Street", "address2": "Apt 1", "balance": "0", "card_expiry_month": 12, "card_expiry_year": 2099, "card_number": "4242424242424242", "city": "Anytown", "company": "Company", "country": "Anycountry", "created_on": "2014-03-01T12:21:59.3456Z", "edited_on": "2014-03-01T12:21:59.3456Z", "enterprise_billing_email": "johndoe@gmail.com", "enterprise_primary_email": "johndoe@gmail.com", "first_name": "John", "is_partner": false, "last_name": "Doe", "next_bill_date": "2014-03-01T12:21:59.3456Z", "payment_address": "123 Main Street", "payment_address2": "Apt 1", "payment_city": "Anytown", "payment_country": "Anycountry", "payment_email": "johndoe@gmail.com", "payment_first_name": "John", "payment_last_name": "Doe", "payment_state": "state", "payment_zipcode": "12345", "primary_email": "johndoe@gmail.com", "state": "AnyState", "tax_id_type": "type", "telephone": "1234567899", "validation_code": "1111", "vat": "GB123456789", "zipcode": "12345" }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "id": "b69a9f3492637782896352daae219e7d", "account_type": "type", "address": "123 Main Street", "address2": "Apt 1", "balance": "0", "card_expiry_month": 12, "card_expiry_year": 2099, "card_number": "4242424242424242", "city": "Anytown", "company": "Company", "country": "Anycountry", "created_on": "2014-03-01T12:21:59.3456Z", "edited_on": "2014-03-01T12:21:59.3456Z", "enterprise_billing_email": "johndoe@gmail.com", "enterprise_primary_email": "johndoe@gmail.com", "first_name": "John", "is_partner": false, "last_name": "Doe", "next_bill_date": "2014-03-01T12:21:59.3456Z", "payment_address": "123 Main Street", "payment_address2": "Apt 1", "payment_city": "Anytown", "payment_country": "Anycountry", "payment_email": "johndoe@gmail.com", "payment_first_name": "John", "payment_last_name": "Doe", "payment_state": "state", "payment_zipcode": "12345", "primary_email": "johndoe@gmail.com", "state": "AnyState", "tax_id_type": "type", "telephone": "1234567899", "validation_code": "1111", "vat": "GB123456789", "zipcode": "12345" }, "success": true } ```