> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Contact Property

> Define a new custom contact property schema for your workspace.

Create custom attributes (such as `company`, `job_title`, `plan`) to attach typed metadata to contacts via the Mailofly API.

### Body Parameters

**name** `string` *required*

Unique field name / key for the property (e.g. `company_name`).

**type** `string` *required*

Data type of the property (`string`, `number`, `boolean`, `date`).

**label** `string`

Human-friendly display label for dashboards.

### Response

**data** `object`

**id** `string`

Unique identifier for the property.

**name** `string`

Field key name.

**type** `string`

Data type.

**createdAt** `string`

Creation timestamp.

```bash cURL theme={null}
curl -X POST https://api.mailofly.com/contact-properties \
  -H "Authorization: Bearer mf_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "plan_tier",
    "type": "string",
    "label": "Plan Tier"
  }'
```

```json 201 Created theme={null}
{
  "data": {
    "id": "prop_123",
    "name": "plan_tier",
    "type": "string",
    "label": "Plan Tier",
    "createdAt": "2026-09-11T13:40:00Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.