Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.recotap.com/llms.txt

Use this file to discover all available pages before exploring further.

POST /accounts/custom-field Creates a new custom field for accounts. The field key is auto-generated from the label and cannot be set manually. Key generation rule: Spaces are replaced with underscores, the result is uppercased, and _C is appended. Only spaces are transformed — all other characters pass through as-is.
LabelGenerated key
Contract ValueCONTRACT_VALUE_C
Net-RevenueNET-REVENUE_C
Revenue (USD)REVENUE_(USD)_C
curl -X POST "http://eapi.recotap.com/api/v1/crm/accounts/custom-field" \
  -H "X-Api-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Contract Value",
    "labelType": "number",
    "description": "Total contract value in USD"
  }'
Request body
FieldTypeRequiredDescription
labelstringYesDisplay name — the key is auto-generated from this e.g. "Contract Value"
labelTypestringYesOne of: singleLineText, multiLineText, singleSelection, multiSelection, number, date
descriptionstringNoHuman-readable description e.g. "Annual contract value in USD". Stored as null if not provided.
optionsstring[]ConditionalRequired (min 1 item) when labelType is singleSelection or multiSelection e.g. ["inbound", "outbound", "partner"]
Response data 
[
  {
    "key": "CONTRACT_VALUE_C",
    "label": "Contract Value",
    "labelType": "number",
    "description": "Total contract value in USD",
    "options": [],
    "objectType": "accounts",
    "status": "active"
  }
]
If a field with the same generated key already exists and is active, the request returns 409 Conflict.