# Create Contact Metadata

Create a new contact property. Select its name and data type, then use it to assign property values for contacts of your choice (with /contactdata).

Endpoint: POST /v3/REST/contactmetadata
Version: 1.0.0
Security: basicAuth

## Request fields (application/json):

  - `Datatype` (string)
    Indicates the type of data accepted for this contact property:

- str - string
- int - integer
- float - float / number
- bool - boolean
- datetime - datetime (Unix Timestamp or RFC 3339)

Default value: str

  - `Name` (string, required)
    Name of the contact property. The name must be unique for the respective namespace.

  - `NameSpace` (string)
    Indicates the namespace of this contact property:

- static - Can keep only 1 value. Each change to the value of the property for a contact overwrites the previously selected value. The values are saved in a contactdata object.
- historic - Each change to the value of the property creates a record in a new contacthistorydata object, saving the property value and a timestamp of when it was submitted.

Default value: static

## Response 201 fields (application/json):

  - `Count` (integer)
    Indicates the number of objects in the Data array.

  - `Data` (array)
    A JSON array containing a list of objects returned by this endpoint.

  - `Data.Datatype` (string)
    Indicates the type of data accepted for this contact property:

- str - string
- int - integer
- float - float / number
- bool - boolean
- datetime - datetime (Unix Timestamp or RFC 3339)

Default value: str

  - `Data.ID` (integer)
    Unique numeric ID for the contact property.

  - `Data.Name` (string)
    Name of the contact property. The name must be unique for the respective namespace.

  - `Data.NameSpace` (string)
    Indicates the namespace of this contact property:

- static - Can keep only 1 value. Each change to the value of the property for a contact overwrites the previously selected value. The values are saved in a contactdata object.
- historic - Each change to the value of the property creates a record in a new contacthistorydata object, saving the property value and a timestamp of when it was submitted.

Default value: static

  - `Total` (integer)
    Indicates the number of objects in the Data array.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields
