POST
/
api
/
people
/
fields
/
curl --location --request POST 'https://app.audienceful.com/api/people/fields/' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <token>' \
--data-raw '{
    "name": "Test Field",
    "data_name": "test_field",
    "type": "string",
    "required": false
}'

{
    "id": "4XJA8RZ6kJRwMJYDBETyZa",
    "name": "Test Field",
    "data_name": "test_field",
    "type": "string",
    "editable": true,
    "required": false
}

​
Body

​
name
string
required
A human readable field name
​
data_name
string
required
The name of the field to be used in future API requests
​
type
string
required
The data type of the field
  • string
  • boolean
  • tag
  • number
​
editable
boolean
default:"true"
Whether or not the field can be edited

​
Response

​
id
string
The id of the field
​
name
string
The human readable name of the field
​
data_name
string
The data name of the field is used in subsequent API requests for people
​
editable
boolean
Allows the field to be edited or not (default fields such as email or tags are not editable)
​
type
string | boolean | tag | number
The type of data stored in the field
curl --location --request POST 'https://app.audienceful.com/api/people/fields/' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <token>' \
--data-raw '{
    "name": "Test Field",
    "data_name": "test_field",
    "type": "string",
    "required": false
}'

{
    "id": "4XJA8RZ6kJRwMJYDBETyZa",
    "name": "Test Field",
    "data_name": "test_field",
    "type": "string",
    "editable": true,
    "required": false
}