Skip to main content
POST
Create a custom field rule

Authorizations

Authorization
string
header
required

API key authentication. Use "Bearer <api_key>" or "Api-Key <api_key>".

Body

application/json
label
string
required

Rule label

Required string length: 1 - 255
source_custom_field_uuid
string
required

Source custom field UUID

action_type
enum<string>
required

Rule action: set_value, show_field, or value_mapping

Available options:
set_value,
show_field,
value_mapping
target_custom_field_uuid
string
required

Target custom field UUID

entity_type
enum<string>
required

Entity type this rule applies to

Available options:
partner,
lead,
lead_deal,
contact
source_values
(string | number | boolean)[]

Values that trigger the rule

Maximum array length: 100
target_value
object · null · null

Value to set when action_type is set_value

value_mappings
object[] | null

Value mapping pairs for value_mapping rules

Maximum array length: 100
locked
boolean

Whether the target field is locked when the rule matches

Response

201 - application/json

Default Response

uuid
string
required
label
string
required
active
boolean
required
source_custom_field_uuid
string
required
source_values
(string | number | boolean)[]
required
action_type
enum<string>
required
Available options:
set_value,
show_field,
value_mapping
target_custom_field_uuid
string
required
target_value
object · null · null
required

Custom field value. Set the key matching the field type: text (text/url/email/phone), number, date, boolean (checkbox), select (option ID), or multi_select (array of option IDs).

value_mappings
object[] | null
required
locked
boolean
required
entity_type
enum<string>
required
Available options:
partner,
lead,
lead_deal,
contact
created_at
string
required
updated_at
string
required