Skip to main content
POST
Create Data Point
Create a Customer Value data point — a custom attribute you send with conversions, which rules can then read as a goal metric or as a payout or revenue source. identifier is the key you send the attribute under. It is lowercased on save and must be unique within the network. type is required, and a value other than text or number is rejected rather than defaulted. Pick it carefully: only number data points can drive a payout or revenue amount, and neither identifier nor type can be changed afterwards — a wrong type means recreating the data point.

Authorizations

X-Eflow-Api-Key
string
header
required

The Everflow API key generated from the Control Center > Security.

Body

application/json
identifier
string
required

The key used to send this data point on a conversion. Lowercased on save and must be unique within the network.

Maximum string length: 255
name
string
required

Display name of the data point.

Maximum string length: 255
type
enum<string>
required

The value type. Required — there is no default, and a value outside text and number is rejected rather than coerced. Cannot be changed after creation, so a wrong type means recreating the data point.

Available options:
text,
number
status
enum<string>
default:active

Whether rules can reference this data point.

Available options:
active,
inactive
description
string

Free-form description of the data point.

Response

200 - application/json
network_id
integer
read-only

Network ID.

Example:

1

data_point_id
integer
read-only

Unique data point ID.

Example:

12

identifier
string

The key used to send this data point on a conversion. Lowercased on save and unique within the network.

Maximum string length: 255
Example:

"subscription_tier"

name
string

Display name of the data point.

Maximum string length: 255
Example:

"Subscription tier"

type
enum<string>

The value type. number data points can be summed and compared and are the only ones usable as a payout or revenue source; text data points support string comparisons only.

Available options:
text,
number
status
enum<string>

Only active data points can be referenced by a rule. Setting a data point to inactive stops new rules from using it.

Available options:
active,
inactive
description
string

Free-form description of the data point.

time_created
integer
read-only

Unix timestamp of creation.

Example:

1734455015

time_saved
integer
read-only

Unix timestamp of last update.

Example:

1734455015