---
title: "Create a contact property"
method: POST
path: "/v1/contacts/properties"
tags: ["Contact properties"]
---

# Create a contact property

`POST /v1/contacts/properties`

Create a custom contact property.

## Request body

- ContactPropertyCreateRequest — There are a few [reserved names](https://loops.so/docs/contacts/properties#reserved-names) that you cannot use for contact properties.
  - `name` string, required — The name of the property. This should be in camelCase, like `planName` or `importDate`.
  - `type` 'string' | 'number' | 'boolean' | 'date', required — The type of property.

## Response `200`

Successful create.

- ContactPropertySuccessResponse
  - `success` boolean, required

## Other responses

- `400` — Bad request (e.g. invalid type).
- `405` — Wrong HTTP request method.

## Changes

> 9 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-07-21** `df77516a130a` — 1 breaking, 4 info
  - request property `type` was restricted to a list of enum values
  - added the new `boolean` enum value to the request property `type`
  - added the new `date` enum value to the request property `type`
  - added the new `number` enum value to the request property `type`
  - …1 more

[Change history](https://skmtc.dev/loops/apis/loops-openapi-spec/changes/v1/contacts/properties/post.md)

---

[API](https://skmtc.dev/loops/apis/loops-openapi-spec.md) · [All operations](https://skmtc.dev/loops/apis/loops-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loops/loops-openapi-spec/revisions/8bd0098300ec/schema)