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 |
|---|---|---|
|
|
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 |
|
|
Updating these fields do not require resubmission. |
Optional |
|
|
Can only be updated once every 3 months. |
Optional |
|
|
Update will reset a |
Yes |
|
|
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"
}