Skip to main content
Brands

Get brand by ID

Retrieves a single brand by its Featurebase ID.

GET
/v2/brands/{id}

Path Parameters

  • id - The Featurebase internal ID of the brand (MongoDB ObjectId)

Response

Returns a brand object with:

  • id - Featurebase internal ID
  • name - Brand display name
  • isDefault - Whether this is the default brand
  • createdAt - Creation timestamp
  • updatedAt - Last update timestamp
  • helpCenterId - Associated help center ID
  • senderEmailAddressId - Default sender email address ID

Example Response

{
  "object": "brand",
  "id": "507f1f77bcf86cd799439011",
  "name": "Default Brand",
  "isDefault": true,
  "createdAt": "2025-01-01T12:00:00.000Z",
  "updatedAt": "2025-01-10T15:30:00.000Z",
  "helpCenterId": "11",
  "senderEmailAddressId": "507f1f77bcf86cd799439012"
}

Error Responses

  • 404 Not Found - Brand with the specified ID does not exist

Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Path Parameters

idstringrequired

The Featurebase internal ID of the brand (MongoDB ObjectId)

Example: 507f1f77bcf86cd799439011

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

createdAtstring | nullrequired

ISO date when brand was created

Example: 2025-01-01T12:00:00.000Z
helpCenterIdstring | nullrequired

The ID of the help center associated with this brand

Example: 11
idstringrequired

Featurebase internal ID

Example: 507f1f77bcf86cd799439011
isDefaultbooleanrequired

Whether this is the default brand

Example: true
namestringrequired

Brand display name

Example: Default Brand
objectenum<string>required

Object type identifier

Available options: brand
Example: brand
senderEmailAddressIdstring | nullrequired

The ID of the default sending email address for this brand

Example: 507f1f77bcf86cd799439012
updatedAtstring | nullrequired

ISO date when brand was last updated

Example: 2025-01-10T15:30:00.000Z

Still need help? Ask the team