API documentation

POST /contact_field_values

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/contact_field_values

Create record.

Add a new picklist value (and its display name) to a contact field.

Params

Param name	Description
contact_field_id Required	Assign the record to this Contact Field. Must be a valid foreign key reference to an Contact Field. Refer to: /api/docs/1.0/contact_fields
value Required	Value Must be a String
name Optional Blank value allowed	Display Name For Value Must be a String
sortable_order Optional Blank value allowed	The order in which records will be sorted. Values are sorted in ascending order; smaller values are listed first. Must be a decimal number.
token_value_ids Optional Blank value allowed	Only offers this picklist value for calls matching these token values. Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Token Value. Refer to: /api/docs/1.0/token_values
record_token_filter_list Optional Blank value allowed	Assign filters to the object by passing an array of key:value pairs Must be a valid list of filters. Example filters: `"interest:auto", "loan_amount:>=10000", "loan_amount:<=50000", "geo:!=800", "caller_id:!=anonymous"`

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/contact_field_values/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "contact_field_id": 10001,
  "value": "yes",
  "name": "Yes"
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "contact_field_value": {
    "id": 10002,
    "type": "ContactFieldValue",
    "uuid": null,
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/contact_field_values/10002",
    "routes_edit_path": "/contact_field_values/10002/edit",
    "external_record_id": null,
    "contact_field_id": 10001,
    "sortable_order": 1,
    "key": "vehicle_year",
    "value": "yes",
    "name": "Yes",
    "record_token_filter_id": null,
    "record_token_filter_data_count": 0,
    "record_token_filter_data": []
  },
  "metadata": {
    "root": "contact_field_value"
  }
}