Reference Hub API

Overview

The Reference Hub API allows you to create, manage, and scale table-based reference data known as Reference Tables for use across your Talkdesk contact center workflows. Previously, Reference Tables functionality was only accessible through the platform UI. This API enables you to integrate Reference Tables directly into your own systems, automating table creation, row management, and bulk data operations at scale.

📘
Use Case
Consider the case where your organization maintains reference data (such as routing rules, product SKUs, or agent skill mappings) in an external system of record. Instead of manually recreating and updating this data in the Talkdesk UI, you can use the Reference Hub API to create tables, import rows in bulk, and keep them synchronized programmatically.

Access and Registration

Authentication

APIs

Usages

Get usage list for a specific data table
- Endpoint: GET https://api.talkdeskstg.com/data-tables/{data_table_id}/usages

Bulk Operations

Bulk operation for data tables (add teams / remove teams)
- Endpoint: POST https://api.talkdeskstg.com/data-tables/bulk
Bulk operation for table rows
- Endpoint: POST https://api.talkdeskstg.com/data-tables/{data_table_id}/rows/bulk

Data Table ID

Get data table schema
- Endpoint: GET https://api.talkdeskstg.com/data-tables/{data_table_id}

Row

Fetch paginated list of data table rows
- Endpoint: GET https://api.talkdeskstg.com/data-tables/{data_table_id}/rows
Create a data table row
- Endpoint: POST https://api.talkdeskstg.com/data-tables/{data_table_id}/rows
Edit a data table row
- Endpoint: PUT https://api.talkdeskstg.com/data-tables/{data_table_id}/rows/{row_id}

Metadata

Partially update a data table's metadata (name, description, team_ids) without modifying columns
- Endpoint: PATCH https://api.talkdeskstg.com/data-tables/{data_table_id}/metadata

Schema

Partially update a data table's schema (columns) without modifying metadata (name, description, team_ids)
- Endpoint: PATCH https://api.talkdeskstg.com/data-tables/{data_table_id}/schema

Import

Import rows into a data table by uploading a CSV or JSON file
- Endpoint: POST https://api.talkdeskstg.com/data-tables/{data_table_id}/rows/import
Create a new data table and immediately import rows from a CSV or JSON file
- Endpoint: POST https://api.talkdeskstg.com/data-tables/import

Export

Create an asynchronous export job for data table rows
- Endpoint: POST https://api.talkdeskstg.com/data-tables/export/jobs
Fetch a paginated list of the asynchronous export jobs
- Endpoint: GET https://api.talkdeskstg.com/data-tables/export/jobs
Get the export file download link
- Endpoint: GET https://api.talkdeskstg.com/data-tables/export/file/{jobId}

Supported Regions and Base URLs

📘
API Availability
The Reference Hub API is available as of August 2026.

Troubleshooting

If you have questions or technical issues, please open a ticket using this form.