# Create Custom Field

```
POST 
/v1/:slug/custom_fields
```

Creates a custom field. For a select field (the default) an existing field with the same name has its full option set replaced. For a date, person or url field pass field\_type and no options; an existing field with the same name and type is returned unchanged.

## Request[​](#request "Direct link to request")

## Responses[​](#responses "Direct link to Responses")

* 200
* 401
* 403
* 422

successful

unauthenticated

not authorized to manage field definitions

when options are empty, the name is the built-in Status, or the plan limit is reached