Skip to main content
POST
Required scopes: customers:rw

Authorizations

​
Authorization
string
header
required

Use your account ID as the username and your personal access token (PAT) as the password, or pass a Base64-encoded value directly in the Authorization header. For more information, see the personal access tokens guide.

Body

application/json
​
name
string
required

The property name. It cannot be empty and must be unique within the organization.

Maximum string length: 128
​
type
enum<string>
required

The customer property value type. You cannot change type after creating the property. A text value can contain up to 5,000 characters. Properties of type text do not support allowed_values.

Available options:
bool,
string,
number,
timestamp,
link,
text
​
type_configuration
object

The configuration for a customer property type. Only timestamp properties support format. Properties of type text do not support allowed_values.

Example:
​
description
string
Maximum string length: 512

Response

The created customer property definition.

​
id
string<uuid>
required

Unique identifier generated when the property is created.

​
name
string
required

A human-readable property name. It must be unique within the organization. The property name is also displayed in the Text app.

Maximum string length: 128
​
type
enum<string>
required

The customer property value type. You cannot change type after creating the property. A text value can contain up to 5,000 characters. Properties of type text do not support allowed_values.

Available options:
bool,
string,
number,
timestamp,
link,
text
​
type_configuration
object
required

The configuration for a customer property type. Only timestamp properties support format. Properties of type text do not support allowed_values.

Example:
​
has_value
boolean
required

If true, at least one customer has a value set for this property.

​
description
string
Maximum string length: 512