TCR Developer Portal
Breadcrumbs

Update a Brand

Updates a brand’s information following registration, but some restrictions apply. Supports modifying most fields specified during registration. Some fields can only be updated once within a given timeframe while others will change a brand’s Identity Status to UNVERIFIED. A brand that is UNVERIFIED cannot create new campaigns, and will require reverification using the PUT /brand/{brandId}/revet endpoint.

Properties

Description

Resubmission Required

companyName, ein, einIssuingCountry, entityType

An update is allowed if the brand has no external vets and no active campaigns. Modifying these fields will change the brand’s Identity Status to UNVERIFIED.

Yes

firstName, lastName, displayName, website, street, city, state, postalCode, country, email, referenceId, phone, vertical, stockSymbol, stockExchange, altBusinessId, altBusinessIdType

Updating these fields do not require resubmission.

Optional

brandRelationship

Can only be updated once every 3 months.

Optional

businessContactEmail

Update will reset a PUBLIC_PROFIT brand’s Identity Status to UNVERIFIED

Yes

mobilePhone

Modifying this field will change the brand’s Identity Status to UNVERIFIED.

Yes

Request

PUT /brand/{brandId}

curl -X 'PUT' \
  'https://csp-api-staging.campaignregistry.com/v2/brand/BABC123' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "street": "100 Michigan Ave",
  "city": "Ypsilanti",
  "state": "MI",
  "postalCode": "48197",
  "country": "US",
  "email": "janedoe@example.com",
  "website": "http://www.examplebrandname.com"
}'

Response

{
  "entityType": "NON_PROFIT",
  "cspId": "S123ABC",
  "brandId": "B123ABC",
  "status": "ACTIVE",
  "displayName": "Example Brand",
  "companyName": "Example Brand, Inc.",
  "ein": "000000XXX",
  "einIssuingCountry": "US",
  "phone": "+15555555555",
  "street": "100 Michigan Ave",
  "city": "Ypsilanti",
  "state": "MI",
  "postalCode": "48197",
  "country": "US",
  "email": "janedoe@example.com",
  "website": "http://www.examplebrandname.com",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "EDUCATION",
  "universalEin": "US_000000XXX",
  "optionalAttributes": {
    "taxExemptStatus": "501c3"
  },
  "mock": false,
  "identityStatus": "VERIFIED",
  "createDate": "2025-06-10T19:16:02.000Z",
  "businessContactEmail": "johndoe@example.com"
}