---
title: "The custom field definitions for one CRM record type. `recordType` defaults to `deal` so callers written before companies had fields — including a web bundle a browser is still holding — keep getting the list they asked for."
method: GET
path: "/crm/settings/custom-fields"
tags: ["CRM Settings"]
---

# The custom field definitions for one CRM record type. \`recordType\` defaults to \`deal\` so callers written before companies had fields — including a web bundle a browser is still holding — keep getting the list they asked for.

`GET /crm/settings/custom-fields`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/crm/settings/custom-fields`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - API key in header `x-meetergo-api-user-id`

## Query parameters

- `recordType` 'deal' | 'company'

## Response `200`

- CrmCustomFieldsDto
  - `fields` CrmCustomFieldDto[], required
    - `id` string, required
    - `key` string, required
    - `label` string, required
    - `type` 'text' | 'textarea' | 'number' | 'currency' | 'date' | 'select' | 'multiselect' | 'checkbox', required
    - `required` boolean, required
    - `options` string[]
    - `order` number, required

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)