---
title: "Update an account"
method: PATCH
path: "/accounts/{id}"
tags: ["Accounts"]
---

# Update an account

`PATCH /accounts/{id}`

Updates an Account

## Path parameters

- `id` string, required — The ID for the account to update.

## Request body

- AccountUpdateParams — Parameters for updating an existing account.
  - `brand_name` string — The name by which the people this account communicates with know it. If not provided, this will match the name field.
  - `name` string — The name of the account that will be visible for your internal organizational purposes. This will also be the default public-facing brand name unless you also set a `brand_name`, but otherwise the account name will never be displayed anywhere outside of Surge HQ, and may include your ID for the account or anything else that may help you.
  - `organization` OrganizationParams — Parameters describing the legal entity on whose behalf the account will be operated.
    - `address` object — The address of the organization's headquarters.
      - `country` string, nullable — The two character ISO 3166 country code. If none is provided, the organization's country code will be used.
      - `line1` string, nullable — The first line of the address, typically the number and street name
      - `line2` string, nullable — The second line of the address if needed, typically an apartment or suite number
      - `locality` string, nullable — The city or locality
      - `name` string, nullable — The name to which any mail should be addressed. If none is provided, this will default to the organization's registered_name
      - `postal_code` string, nullable — The postal code
      - `region` string, nullable — The state or region
    - `contact` object, nullable — An object representing an individual who can be contacted if Surge or our carrier partners have any questions about the business. If you are registering on behalf of your customer, this must be a contact from your customer's company rather than your own. The individual will likely never be contacted unless there are issues with spam.
      - `email` string, email, nullable — An email address at which the individual can be reached. Typically an email using the same domain name as the website URL will be preferred (e.g. with a website domain of `https://dtprecisionauto.com`, an email like `dom@dtprecisionauto.com` will be preferred over one like `dom@anothergarage.com` or `dom.toretto@gmail.com`. `dtprecisionauto@gmail.com` would also be acceptable, but not preferred)
      - `first_name` string, nullable — The first name (or given name) of the individual
      - `last_name` string, nullable — The last name (or family name) of the individual
      - `phone_number` string, nullable — A phone number at which the individual can be reached (E.164 format)
      - `title` 'ceo' | 'cfo' | 'director' | 'gm' | 'vp' | 'general_counsel' | 'other', nullable — The job title of the individual.
      - `title_other` string, nullable — If `other` is provided for the `title` field, this field should be used to provide the title of the individual
    - `country` string, nullable — The two character ISO 3166 country code for the country in which the organization is headquartered.
    - `email` string, email, nullable — For publicly traded companies, an email for a representative of the company to whom a verification email will be sent. This must be an email on the same domain as the company's website (e.g. with a website domain of `https://dtprecisionauto.com`, the email must use the same `@dtprecisionauto.com`)
    - `identifier` string, nullable — The value of the identifier whose type is specified in the identifier_type field. For EIN, can be formatted with or without the hyphen. For CBN, must be exactly 9 digits.
    - `identifier_type` 'ein' | 'cbn', nullable — The type of identifier being provided for the organization. Use "ein" for US businesses or "cbn" for Canadian businesses.
    - `industry` 'agriculture' | 'automotive' | 'banking' | 'construction' | 'consumer' | 'education' | 'electronics' | 'energy' | 'engineering' | 'fast_moving_consumer_goods' | 'financial' | 'fintech' | 'food_and_beverage' | 'government' | 'healthcare' | 'hospitality' | 'insurance' | 'jewelry' | 'legal' | 'manufacturing' | 'media' | 'not_for_profit' | 'oil_and_gas' | 'online' | 'professional_services' | 'raw_materials' | 'real_estate' | 'religion' | 'retail' | 'technology' | 'telecommunications' | 'transportation' | 'travel', nullable — The industry in which the organization operates.
    - `mobile_number` string, nullable — For sole proprietors, this must be a valid US or Canadian mobile phone number to which a verification text message will be sent. (E.164 format)
    - `regions_of_operation` string[], nullable — An array of regions in which the organization operates.
    - `registered_name` string, nullable — The legal name of the organization as registered with the IRS or other relevant authorities. For some applications, this will be matched against government records and should include all punctuation and everything else as well.
    - `stock_exchange` 'amex' | 'amx' | 'asx' | 'b3' | 'bme' | 'bse' | 'fra' | 'icex' | 'jpx' | 'jse' | 'krx' | 'lon' | 'nasdaq' | 'none' | 'nyse' | 'nse' | 'omx' | 'other' | 'sehk' | 'sgx' | 'sse' | 'sto' | 'swx' | 'szse' | 'tsx' | 'twse' | 'vse', nullable — For publicly traded companies, this is the exchange on which the company's stock is traded.
    - `stock_symbol` string, nullable — For publicly traded companies, the ticker symbol for the company's stock
    - `type` 'co_op' | 'government' | 'llc' | 'non_profit' | 'partnership' | 'private_corporation' | 'public_corporation' | 'sole_proprietor', nullable — The type of organization
    - `website` string, nullable — The URL of the website for this organization. The website should be publicly available, clearly reflect the organization's purpose, and the URL should start with `https://`
  - `time_zone` string, nullable — The time zone for the account

## Response `200`

Updated account

- Account — Response containing account information.
  - `brand_name` string, nullable, required — The name by which the people this account communicates with know it. If not provided, this will match the name field.
  - `id` string, required — The account ID
  - `name` string, required — The name of the account that will be visible for your internal organizational purposes. This will also be the default public-facing brand name unless you also set a `brand_name`, but otherwise the account name will never be displayed anywhere outside of Surge HQ, and may include your ID for the account or anything else that may help you.
  - `organization` Organization, required — The legal entity on whose behalf the account will be operated.
    - `address` object, required — The address of the organization's headquarters.
      - `country` string, nullable, required — The two character ISO 3166 country code. If none is provided, the organization's country code will be used.
      - `line1` string, nullable, required — The first line of the address, typically the number and street name
      - `line2` string, nullable, required — The second line of the address if needed, typically an apartment or suite number
      - `locality` string, nullable, required — The city or locality
      - `name` string, nullable, required — The name to which any mail should be addressed. If none is provided, this will default to the organization's registered_name
      - `postal_code` string, nullable, required — The postal code
      - `region` string, nullable, required — The state or region
    - `contact` object, required — An object representing an individual who can be contacted if the carriers have any questions about the business.
      - `email` string, email, nullable, required — An email address at which the individual can be reached. Typically an email using the same domain name as the website URL will be preferred (e.g. with a website domain of `https://dtprecisionauto.com`, an email like `dom@dtprecisionauto.com` will be preferred over one like `dom@anothergarage.com` or `dom.toretto@gmail.com`)
      - `first_name` string, nullable, required — The first name (or given name) of the individual
      - `last_name` string, nullable, required — The last name (or family name) of the individual
      - `phone_number` string, nullable, required — A phone number at which the individual can be reached (E.164 format)
      - `title` 'ceo' | 'cfo' | 'director' | 'gm' | 'vp' | 'general_counsel' | 'other', nullable, required — The job title of the individual.
      - `title_other` string, nullable, required — If `other` is provided for the `title` field, this field should be used to provide the title of the individual
    - `country` string, nullable, required — The two character ISO 3166 country code for the country in which the organization is headquartered.
    - `email` string, email, nullable, required — For publicly traded companies, an email for a representative of the company to whom a verification email will be sent. This must be an email on the same domain as the company's website (e.g. with a website domain of `https://dtprecisionauto.com`, the email must use the same `@dtprecisionauto.com`)
    - `identifier` string, nullable, required — The value of the identifier whose type is specified in the identifier_type field. For EIN, can be formatted with or without the hyphen. For CBN, must be exactly 9 digits.
    - `identifier_type` 'ein' | 'cbn', nullable, required — The type of identifier being provided for the organization. Use "ein" for US businesses or "cbn" for Canadian businesses.
    - `industry` 'agriculture' | 'automotive' | 'banking' | 'construction' | 'consumer' | 'education' | 'electronics' | 'energy' | 'engineering' | 'fast_moving_consumer_goods' | 'financial' | 'fintech' | 'food_and_beverage' | 'government' | 'healthcare' | 'hospitality' | 'insurance' | 'jewelry' | 'legal' | 'manufacturing' | 'media' | 'not_for_profit' | 'oil_and_gas' | 'online' | 'professional_services' | 'raw_materials' | 'real_estate' | 'religion' | 'retail' | 'technology' | 'telecommunications' | 'transportation' | 'travel', nullable, required — The industry in which the organization operates.
    - `mobile_number` string, nullable, required — For sole proprietors, this must be a valid US or Canadian mobile phone number to which a verification text message will be sent. (E.164 format)
    - `regions_of_operation` string[], nullable, required — An array of regions in which the organization operates.
    - `registered_name` string, nullable, required — The legal name of the organization as registered with the IRS or other relevant authorities. For some applications, this will be matched against government records and should include all punctuation and everything else as well.
    - `stock_exchange` 'amex' | 'amx' | 'asx' | 'b3' | 'bme' | 'bse' | 'fra' | 'icex' | 'jpx' | 'jse' | 'krx' | 'lon' | 'nasdaq' | 'none' | 'nyse' | 'nse' | 'omx' | 'other' | 'sehk' | 'sgx' | 'sse' | 'sto' | 'swx' | 'szse' | 'tsx' | 'twse' | 'vse', nullable, required — For publicly traded companies, this is the exchange on which the company's stock is traded.
    - `stock_symbol` string, nullable, required — For publicly traded companies, the ticker symbol for the company's stock
    - `type` 'co_op' | 'government' | 'llc' | 'non_profit' | 'partnership' | 'private_corporation' | 'public_corporation' | 'sole_proprietor', nullable, required — The type of organization
    - `website` string, nullable, required — The URL of the website for this organization. The website should be publicly available, clearly reflect the organization's purpose, and the URL should start with `https://`
  - `time_zone` string, nullable, required — This is the time zone in which the account is headquartered. This time zone may be used for compliance with TCPA restrictions on when messages may be sent.

## Other responses

- `default` — Error

---

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