---
title: "Bulk create contact fields"
method: POST
path: "/v1/contacts/fields/bulk"
tags: ["CRM"]
---

# Bulk create contact fields

`POST /v1/contacts/fields/bulk`

Creates contact custom field definitions in bulk.

## Request body

- FieldCreateInput[]
  - `name` string, required
  - `property_name` string — Optional stable field key. If omitted, Octolane generates a unique property name.
  - `attribute_type` 'string' | 'number' | 'checkbox' | 'date' | 'date_range' | 'rating' | 'timestamp' | 'select' | 'multi_select' | 'currency' | 'percentage' | 'location' | 'time' | 'datetime' | 'email' | 'phone' | 'website' | 'url' | 'radio' | 'team_members', required
  - `metadata` object, nullable — Optional field metadata. For select fields, include `select_options` with label/value/color/order entries.
  - `order` integer, nullable
  - `is_hidden` boolean

## Response `200`

Contact fields were created.

- ApiResponse
  - `success` boolean
  - `message` string
  - `data` unknown

## Other responses

- `201` — Contact fields were created.
- `400` — The request failed validation.
- `401` — The API key is missing, invalid, or not allowed to access this route.
- `429` — The route rate limit was exceeded.

---

[API](https://skmtc.net/octolane-org/apis/octolane-public-api.md) · [All operations](https://skmtc.net/octolane-org/apis/octolane-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octolane-org/octolane-public-api/versions/8c7700f1eeec/schema)