POST

/api/people/fields/

X-Api-Key*

Body

namerequired
string

A human readable field name

data_namerequired
string

The name of the field to be used in future API requests

typerequired
string

The data type of the field

  • string
  • boolean
  • tag
  • number
editable
Default: "true"
boolean

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"
}'
{
    "id": "4XJA8RZ6kJRwMJYDBETyZa",
    "name": "Test Field",
    "data_name": "test_field",
    "type": "string",
    "editable": true
}