---
title: "Update an existing brand"
method: PUT
path: "/messaging-brands/{brand_id}"
tags: ["messagingbrands", "MessagingBrands"]
---

# Update an existing brand

`PUT /messaging-brands/{brand_id}`

## Request

- Base URL: `https://api.fonestorm.com/v2`
- URL: `https://api.fonestorm.com/v2/messaging-brands/{brand_id}`
- Auth: API key in header `token`

Updates a brand

## Path parameters

- `brand_id` string, required

## Request body

- object
  - `companyName` string: The legal name of the business
  - `firstName` string: First name of business contact
  - `lastName` string: Last name of business contact
  - `phone` string: Support contact telephone number in E.164 format
  - `street` string: House number and street name
  - `city` string: City Name
  - `state` string: State or province
  - `postalCode` string: Zipcode or postal code
  - `country` string: Two-letter ISO-2 country code
  - `email` string, email: Email address of support contact
  - `stockSymbol` string: Stock symbol of the PUBLIC_PROFIT brand
  - `stockExchange` 'NONE' | 'NASDAQ' | 'NYSE' | 'AMEX' | 'AMX' | 'ASX' | 'B3' | 'BME' | 'BSE' | 'FRA' | 'ICEX' | 'JPX' | 'JSE' | 'KRX' | 'LON' | 'NSE' | 'OMX' | 'SEHK' | 'SGX' | 'SSE' | 'STO' | 'SWX' | 'SZSE' | 'TSX' | 'TWSE' | 'VSE' | 'OTHER': The stock exchange where the PUBLIC_PROFIT brand is registered
  - `website` string, uri: The website/online URL address of the brand
  - `vertical` string: The industry segment where the brand operates
  - `altBusinessId` string: Alternative Business Identifier
  - `altBusinessIdType` 'NONE' | 'DUNS' | 'GIIN' | 'LEI': Alternative Business Identifier Type
  - `businessContactEmail` string, email: Email of the business contact for the brand

## Response `200`

Brand updated

- object
  - `brand` MessagingBrands
    - `entity_type` 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' | 'SOLE_PROPRIETOR': The type of business entity
    - `brand_id` string: Unique brand identifier
    - `status` 'ACTIVE' | 'PENDING_REVIEW' | 'PENDING_UPDATE' | 'DELETED' | 'SUBMISSION_FAILED': Current status of the brand
    - `display_name` string: Brand/Marketing/DBA name of the business
    - `company_name` string: The legal name of the business
    - `ein` string: Tax ID of the business
    - `ein_issuing_country` string: Two-letter ISO-2 country code of Tax ID issuing country
    - `phone` string: Support contact telephone number in E.164 format
    - `street` string: House number and street name
    - `city` string: City name
    - `state` string: State or province
    - `postal_code` string: Zipcode or postal code
    - `country` string: Two-letter ISO-2 country code
    - `email` string: Email address of support contact
    - `ip_address` string: IP address associated with the brand
    - `website` string: The website/online URL address of the brand
    - `vertical` string: The industry segment where the brand operates
    - `universal_ein` string: Universal tax ID in format COUNTRY_EIN
    - `identity_status` 'VETTED_VERIFIED' | 'UNVERIFIED' | 'VETTED_REJECTED': Current vetting status of the brand
    - `registered_on` string, date-time: Date and time when the brand was created

## Other responses

- `202`: Brand update request pending review
- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `default`: Error

---

[API](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail.md) · [All operations](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/llms.txt) · [OpenAPI document](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/revisions/9738d9b806d4?raw)