> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Manage custom contact fields in your Allo CRM

Custom fields add your own data to people, such as a lead source or a budget. The Custom fields API lets you list the fields defined on your team and create new ones.

## Scopes

| Scope | Access |
| - | - |
| `CRM_READ` | List custom fields |
| `CRM_WRITE` | Create custom fields |

## Field types

| Type | Created with the API | Notes |
| - | - | - |
| `TEXT` | yes | |
| `NUMBER` | yes | |
| `DATE` | yes | |
| `BOOLEAN` | yes | |
| `DROPDOWN` | no | Synced from your CRM integrations. Listed, but cannot be created here. |

## Keys

Each field has a `key`, derived from its label: lowercase, accents removed, runs of non-alphanumeric characters replaced by `_`, truncated to 64 characters. `Lead Source` becomes `lead_source`.

## Limits

A team can hold up to 150 `TEXT`, 50 `NUMBER`, 30 `DATE` and 30 `BOOLEAN` custom fields. Creating a field beyond the limit for its type returns `ATTRIBUTE_SLOTS_EXHAUSTED`.

Custom fields are available on workspaces that use the new contact model. Other workspaces get a `404 TEAM_NOT_FOUND`.

## Endpoints

<CardGroup cols={1}>
  <Card title="List custom fields" href="/en/v2/api-reference/crm/list-attributes">List the custom fields of your people</Card>
  <Card title="Create custom field" href="/en/v2/api-reference/crm/create-attribute">Create a custom field</Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.