Allo

List company attributes

Returns the custom attributes defined on your team's companies, paginated, including the ones synced from your CRM integrations. Archived attributes are not…

GET/v2/api/crm/companies/attributes

Returns the custom attributes defined on your team's companies. The list includes the attributes you created and the ones synced from your CRM integrations. Archived attributes are not listed.

Query parameters

ParameterTypeDefaultDescription
pageinteger1Page number, starting at 1
sizeinteger20Items per page, from 1 to 100

Response fields

FieldTypeDescription
keystringUnique key of the attribute
labelstring or nullDisplay name
typestring or nullTEXT, NUMBER, DATE, BOOLEAN or DROPDOWN
optionsarray or null{ key, label } objects. Only set for DROPDOWN
is_visiblebooleanWhether the attribute is shown in the Allo apps
promptstring or nullInstruction the AI CRM Manager uses to fill the attribute from calls
should_prompt_overrideboolean or nullWhether the AI may overwrite an existing value
sourcestringallo, or the integration that manages the attribute, such as hubspot
created_atstringISO 8601 date-time
updated_atstringISO 8601 date-time
{
  "data": [
    {
      "key": "employees",
      "label": "Employees",
      "type": "NUMBER",
      "options": null,
      "is_visible": true,
      "prompt": null,
      "should_prompt_override": null,
      "source": "hubspot",
      "created_at": "2026-10-07T14:21:08",
      "updated_at": "2026-10-07T14:21:08"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total_count": 1,
    "total_pages": 1,
    "has_more": false
  }
}

Errors

StatusCodeWhen
400INVALID_PAGE_SIZEpage is below 1, or size is outside 1 to 100
403API_KEY_INSUFFICIENT_SCOPEThe key does not hold CRM_READ
404TEAM_NOT_FOUNDThe workspace is not on the new contact model

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Query parameters

pageinteger

Page number (1-indexed)

sizeinteger

Results per page

Responses

200List of company attributes
dataobject[]
10 fields
keystring

Unique key within your team

labelstring | null

Display name

typeenum<string>

TEXTNUMBERDATEBOOLEANDROPDOWN

optionsobject[]

Allowed values. Only set for DROPDOWN attributes.

2 fields
keystring
labelstring
is_visibleboolean

Whether the attribute is shown in the Allo apps

promptstring | null

Instruction the AI CRM Manager follows to fill this attribute from calls. A blank value clears it.

should_prompt_overrideboolean | null

Whether the AI may overwrite a value that is already set

sourcestring

allo for attributes created in Allo or with the API, otherwise the lowercase name of the integration that manages it, such as hubspot

created_atstring<date-time>
updated_atstring<date-time>
paginationobject
5 fields
pageinteger
sizeinteger
total_countinteger
total_pagesinteger
has_moreboolean
400
401
403
404
429