API ReferenceBrands

Create or Update a Brand

Create a new brand or update an existing brand by with the provided information.

Headers

PINNACLE-API-KEYstringRequired

Request

This endpoint expects an object.
addressstring or nullOptional
Primary brand address where the company is located.
contactobject or nullOptional
Contact information for the brand.
dbastring or nullOptional

“Doing Business As” name - the public name the brand operates under.

descriptionstring or nullOptional
Brief description of what the brand does.
einstring or nullOptionalformat: "^[0-9]{2}-[0-9]{7}$"

Brand’s Employer Identification Number (EIN) assigned by the IRS.

emailstring or nullOptional
Main contact email address for the brand.
idintegerOptional>=1

Brand ID - include only when updating an existing brand, omit to create a new one.

namestring or nullOptional
Legal name of the brand as registered.
sectorenum or nullOptional
Industry the brand operates in.
typeenum or nullOptional
Legal structure of the brand.
Allowed values:
websitestring or nullOptionalformat: "url"
Brand website URL.

Response

Successfully create/updated the brand.

createdAtstring
ISO 8601 formatted timestamp of when this brand was added to our system.
idinteger
The brand's ID.
isArchivedboolean
Indicates if this brand is archived.
statusenum

Current review status of the campaign.

INCOMPLETE: Not submitted.

IN REVIEW: Being reviewed by carriers.

VERIFIED: Approved and ready to send messages.

FAILED: Issues and errors related to the campaign’s details.

updatedAtstring
ISO 8601 formatted timestamp of when this brand was last updated.
addressstring or null
Primary brand address where this brand is located.
contactobject or null
Contact information for the primary brand representative.
dbastring or null

“Doing Business As” name - the public name this brand operates under.

descriptionstring or null
Brief description of what this brand does.
einstring or null

Employer Identification Number (EIN) assigned by the IRS.

emailstring or null
Main contact email address for this brand.
namestring or null
Legal name of the brand as registered.
sectorenum or null
Industry the Brand operates in.
typeenum or null
Legal structure of the brand.
Allowed values:
websitestring or null
Brand website URL.

Errors