---
title: "Get a custom field"
method: GET
path: "/v1/custom-fields/{custom_field_id}"
tags: ["Custom Fields"]
---

# Get a custom field

`GET /v1/custom-fields/{custom_field_id}`

## Request

- Base URL: `https://api.mailrith.com`
- URL: `https://api.mailrith.com/v1/custom-fields/{custom_field_id}`
- Auth: HTTP bearer

Returns one custom field from the authenticated workspace, including its exact ready-to-use email personalization token.

## Path parameters

- `custom_field_id` string, required

## Response `200`

Successful response

- object
  - `data` CustomField, required
    - `self` string, required: Stable relative Public API path for retrieving this resource.
    - `id` string, required
    - `label` string, required
    - `type` string, required
    - `settings` object, required
      - `options` string[], required
    - `personalization_token` string, required: The exact ready-to-use token for this custom field. Copy it into an email subject or body text node and replace only the fallback text when needed. This value is computed from the current field label and is not stored separately.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `404`: Resource not found

---

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