API documentation

GET /call_centers

Authorization Required

https://[your-subdomain].trackdrive.net/api/v1/call_centers

List Call Center records.

List the call centers configured in your account, used to group agents under a shared softphone provider.

Params

Param name	Description
page Optional	Return the next page of results. Must be a number.
per_page Optional	How many results to return per page. The default is 25. Must be a number.
created_at_to Optional	Date formatted like 2016-01-01 12:25:15 -0500 Must be a String
created_at_from Optional	Date formatted like 2016-01-01 12:25:15 -0500 Must be a String
fulltext Optional	Search for any record that matches this text Must be a String
time_zone Optional	Date ranges will be parsed using this time zone. Must be a valid time zone. See the list of valid time zones.
columns Optional	Specify the columns you would like returned by the API for a given resource. Limiting the columns can significantly increase API response time since only the requested data will be processed. columns=uuid,number,created_at Must be any combination of: id legacy_id type uuid created_at updated_at deleted_at user_updated_at routes_show_path routes_edit_path external_record_id company_id user_id sortable_order name description user_call_center_id context_menu_name softphone_host record_token_additional_id record_token_additional_data_count record_token_additional_data Must be a String
root Optional	Pass `root=false` to return results without a root node and metadata. For example: `GET /api/v1/calls?root=false` will return `[call1, call2, call3]` While: `GET /api/v1/calls` will return `{calls: [call1, call2, call3], metadata: {}}` Must be a boolean value: 1, true, yes, on, 0, false, no, off

Example Request

curl 'https://[your-subdomain].trackdrive.net/api/v1/call_centers/?per_page=2' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "call_centers": [
    {
      "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "type": "CallCenter",
      "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "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": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "routes_edit_path": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
      "external_record_id": "example-record-1",
      "company_id": 10001,
      "user_id": null,
      "sortable_order": 1,
      "name": "Main Floor",
      "description": "Primary call center floor for general inbound calls",
      "user_call_center_id": "main_floor",
      "context_menu_name": "Main Floor",
      "softphone_host": "plivo",
      "record_token_additional_id": null,
      "record_token_additional_data_count": 0,
      "record_token_additional_data": []
    },
    {
      "id": "a09e6bca-255b-4217-af73-cb9601c80217",
      "type": "CallCenter",
      "uuid": "a09e6bca-255b-4217-af73-cb9601c80217",
      "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": "/call_centers/a09e6bca-255b-4217-af73-cb9601c80217",
      "routes_edit_path": "/call_centers/a09e6bca-255b-4217-af73-cb9601c80217/edit",
      "external_record_id": "example-record-1",
      "company_id": 10001,
      "user_id": null,
      "sortable_order": 2,
      "name": "Premium Sales",
      "description": "Dedicated team for high-value insurance and legal leads",
      "user_call_center_id": "premium_sales",
      "context_menu_name": "Premium Sales",
      "softphone_host": "plivo",
      "record_token_additional_id": null,
      "record_token_additional_data_count": 0,
      "record_token_additional_data": []
    }
  ],
  "metadata": {
    "root": "call_centers",
    "page": 1,
    "total_pages": 3,
    "per_page": 2,
    "total_count": 6,
    "next_cursor": 10002
  }
}

GET /call_centers/new

Authorization Required

https://[your-subdomain].trackdrive.net/api/v1/call_centers/new

Build Call Center with defaults.

Return a new, unsaved call center pre-filled with defaults.

Params

Param name	Description
name Optional Blank value allowed	Name Must be a String
description Optional Blank value allowed	Description Must be a String
user_call_center_id Optional Blank value allowed	Your external ID for this call center. Must be a String
record_token_additional_id Optional Blank value allowed	Record Token Additional Must be a String
external_record_id Optional Blank value allowed	Your own identifier for this call center, used to correlate it with a record in an external system. Must be a String
attribution_token_value_ids Optional Blank value allowed	The ids of the Token Values whose tokens will be additionally applied to calls handled by this call center. 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_additional_list Optional Blank value allowed	Assign additional tokens that will be applied to leads and calls by passing a comma separated string of key:value pairs. Must be a valid list of tokens. Example tokens: `buyer_interest:loan,another_token:value`

Example Request

curl 'https://[your-subdomain].trackdrive.net/api/v1/call_centers/new' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "call_center": {
    "id": null,
    "type": "CallCenter",
    "uuid": null,
    "created_at": null,
    "updated_at": null,
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/call_centers/new",
    "routes_edit_path": "/call_centers/new",
    "external_record_id": null,
    "company_id": 10001,
    "user_id": null,
    "sortable_order": null,
    "name": null,
    "description": null,
    "user_call_center_id": null,
    "context_menu_name": null,
    "softphone_host": "trackdrive",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "call_center"
  }
}

POST /call_centers

Authorization Required

https://[your-subdomain].trackdrive.net/api/v1/call_centers

Create Call Center.

Create a call center with a name and your own external identifier (user_call_center_id), and choose the softphone provider its agents will connect through.

Params

Param name	Description
name Optional Blank value allowed	Name Must be a String
description Optional Blank value allowed	Description Must be a String
user_call_center_id Optional Blank value allowed	Your external ID for this call center. Must be a String
record_token_additional_id Optional Blank value allowed	Record Token Additional Must be a String
external_record_id Optional Blank value allowed	Your own identifier for this call center, used to correlate it with a record in an external system. Must be a String
attribution_token_value_ids Optional Blank value allowed	The ids of the Token Values whose tokens will be additionally applied to calls handled by this call center. 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_additional_list Optional Blank value allowed	Assign additional tokens that will be applied to leads and calls by passing a comma separated string of key:value pairs. Must be a valid list of tokens. Example tokens: `buyer_interest:loan,another_token:value`

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.net/api/v1/call_centers/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Example Call Center",
  "description": "A call center created for this example",
  "user_call_center_id": "example_call_center"
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "call_center": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "CallCenter",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "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": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "routes_edit_path": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": null,
    "company_id": 10001,
    "user_id": null,
    "sortable_order": 14,
    "name": "Example Call Center",
    "description": "A call center created for this example",
    "user_call_center_id": "example_call_center",
    "context_menu_name": "Example Call Center",
    "softphone_host": "trackdrive",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "call_center"
  }
}

GET /call_centers/:id

Authorization Required

https://[your-subdomain].trackdrive.net/api/v1/call_centers/:id

Get Call Center by id.

Retrieve a single call center by id.

Example Request

curl 'https://[your-subdomain].trackdrive.net/api/v1/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "call_center": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "CallCenter",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "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": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "routes_edit_path": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": "example-record-1",
    "company_id": 10001,
    "user_id": null,
    "sortable_order": 1,
    "name": "Main Floor",
    "description": "Primary call center floor for general inbound calls",
    "user_call_center_id": "main_floor",
    "context_menu_name": "Main Floor",
    "softphone_host": "plivo",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "call_center"
  }
}

PUT /call_centers/:id

Authorization Required

https://[your-subdomain].trackdrive.net/api/v1/call_centers/:id

Update Call Center by id.

Rename a call center or change its softphone provider. Changing the provider re-applies it to the softphone URLs of the call center's agents.

Params

Param name	Description
name Optional Blank value allowed	Name Must be a String
description Optional Blank value allowed	Description Must be a String
user_call_center_id Optional Blank value allowed	Your external ID for this call center. Must be a String
record_token_additional_id Optional Blank value allowed	Record Token Additional Must be a String
external_record_id Optional Blank value allowed	Your own identifier for this call center, used to correlate it with a record in an external system. Must be a String
attribution_token_value_ids Optional Blank value allowed	The ids of the Token Values whose tokens will be additionally applied to calls handled by this call center. 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_additional_list Optional Blank value allowed	Assign additional tokens that will be applied to leads and calls by passing a comma separated string of key:value pairs. Must be a valid list of tokens. Example tokens: `buyer_interest:loan,another_token:value`

Example Request

curl -X PUT 'https://[your-subdomain].trackdrive.net/api/v1/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Example Call Center (renamed)"
}'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "call_center": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "CallCenter",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "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": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "routes_edit_path": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": null,
    "company_id": 10001,
    "user_id": null,
    "sortable_order": 15,
    "name": "Example Call Center (renamed)",
    "description": "A call center created for this example",
    "user_call_center_id": "example_call_center",
    "context_menu_name": "Example Call Center (renamed)",
    "softphone_host": "trackdrive",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "call_center"
  }
}

DELETE /call_centers/:id

Authorization Required

https://[your-subdomain].trackdrive.net/api/v1/call_centers/:id

Destroy Call Center by id.

Permanently delete a call center.

Example Request

curl -X DELETE 'https://[your-subdomain].trackdrive.net/api/v1/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "call_center": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "CallCenter",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": "2026-01-15T15:30:00.000Z",
    "user_updated_at": null,
    "routes_show_path": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "routes_edit_path": "/call_centers/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": null,
    "company_id": 10001,
    "user_id": null,
    "sortable_order": 15,
    "name": "Example Call Center",
    "description": "A call center created for this example",
    "user_call_center_id": "example_call_center",
    "context_menu_name": "Example Call Center",
    "softphone_host": "trackdrive",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "call_center"
  }
}

Params

Must be any combination of:

Params

Params

Params