API documentation

POST /zoho_crm_commands

Authorization Required

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

Create Zoho Action.

Creates a Zoho Action tied to a schedule action, an action_type (create_module_entry, convert_lead, create_update_module_entry, or update_module_entry), and a Zoho module_type. On creation the integration calls out to Zoho live to fetch that modules field list and auto-generate its field mappings, so the parent schedule action must already have a working Zoho connection.

Params

Param name	Description
schedule_action_id Optional Blank value allowed	Schedule Action Must be a valid foreign key reference to an Schedule Action. Refer to: /api/docs/1.0/schedule_actions
action_type Optional Blank value allowed	Action Type Must be a String
module_type Optional Blank value allowed	Module Type Must be a String
module_primary_key Optional Blank value allowed	Module Primary Key Must be a String
zoho_parent_type Optional Blank value allowed	The Zoho CRM module (for example Leads or Contacts) a Notes action attaches its note to. Must be a String
token_value_map_group_ids Optional Blank value allowed	Map lead and call data to custom values by assigning these Token Value Map Groups to this action. Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Filter Mapping Group. Refer to: /api/docs/1.0/token_value_map_groups

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/zoho_crm_commands/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "schedule_action_id": 10003,
  "action_type": "create_module_entry",
  "module_type": "Contacts"
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "zoho_crm_command": {
    "id": "10001111-2222-4333-a444-555566667777",
    "type": "ZohoCrmCommand",
    "uuid": "10001111-2222-4333-a444-555566667777",
    "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": "/zoho_crm_commands/10001111-2222-4333-a444-555566667777",
    "routes_edit_path": "/zoho_crm_commands/10001111-2222-4333-a444-555566667777/edit",
    "external_record_id": null,
    "company_id": 10001,
    "user_id": 10002,
    "schedule_action_id": 10003,
    "sortable_order": 1,
    "action_type": "create_module_entry",
    "module_type": "Contacts",
    "module_primary_key": null,
    "token_value_map_group_ids": [],
    "webhook_params_count": 6,
    "response_parsers_count": 0,
    "zoho_parent_type": null
  },
  "metadata": {
    "root": "zoho_crm_command"
  }
}