---
title: "Create custom fields"
method: POST
path: "/v1/custom-fields"
tags: ["Custom Fields"]
---

# Create custom fields

`POST /v1/custom-fields`

## Request body

- CustomFieldInputListSchema
  - `items` CustomFieldInputSchema[], required — List of custom fields to create.
    - `name` string, required — The name of the custom field.
    - `type` 'single-select' | 'multi-select' | 'string', required
    - `external_id` string, nullable — The external accounting ID of the custom field.
  - `notification_preferences` union[], required — List of notification preferences for when custom field creation has completed.
    - union
      - EmailPreference
        - `email` string, required — Email address to send notifications to.
      - WebhookPreference
        - `url` string, required — Webhook URL to send notifications to.

## Response `202`

Custom field creation request received

## Other responses

- `400` — Invalid request data

---

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