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

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