---
title: "Create a Custom Field"
method: POST
path: "/fields"
tags: ["Miscellaneous"]
---

# Create a Custom Field

`POST /fields`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

The Create a Custom Field endpoint lets you add custom fields to your Apollo account, helping your team capture unique details with <a href="https://knowledge.apollo.io/hc/en-us/articles/4412498825869-Create-Custom-Contact-Fields" target="_blank">custom contact</a>, <a href="https://knowledge.apollo.io/hc/en-us/articles/4412498754445-Create-Custom-Account-Fields" target="_blank">custom account</a>, or <a href="https://knowledge.apollo.io/hc/en-us/articles/4415062486669-Create-a-Deal" target="_blank">custom deal fields</a>.<br><br>Use these fields to enhance your sequences and deliver more personalized, relevant outreach.

## Request body

- object
  - `label` string — Name of the custom field you want to create. Example: `Test Name`
  - `modality` 'contact' | 'account' | 'opportunity' — The modality of the custom field you want to create. Example: `contact`
  - `type` 'string' | 'textarea' | 'number' | 'date' | 'datetime' | 'boolean' — What kind of custom field you want to create. Example: `textarea`
  - `meta` object
    - `max_length` number

## Response `200`

200

- object
  - `typed_custom_fields` object[]
    - `id` string
    - `name` string
    - `modality` string
    - `text_field_max_length` number

## Other responses

- `401` — 401
- `403` — 403

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)