For AI agents: the docs index is at https://docs.talkdesk.com/llms.txt. Append .md to any documentation page URL to get its markdown version.
Jump to Content
Talkdesk DevelopersGuidesAPI EndpointsKnowledge BaseSupportTalkdesk WebsiteMarketplaceDiscussions API Change LogOpenAPI Specification Download
HomeGuidesAPI Endpoints API Change LogOpenAPI Specification Download
GuidesAPI EndpointsKnowledge BaseSupportTalkdesk WebsiteMarketplaceDiscussions API Change LogOpenAPI Specification DownloadLog InHomeTalkdesk Developers
API Endpoints
Log InHome
OpenAPI Specification Download

Getting Started

  • API Endpoints

Public API

  • Accounts API
    • Get account detailsget
  • Digital Connect API
    • Create digital-connect conversationpost
    • Create digital-connect conversationpost
    • delete digital-connect conversationdel
  • Financial Services Experience Cloud for Banking
    • Update Talkdesk contact found by phone number or contact id with the Fsi member information.post
  • FSI Integrations API
    • Returns contact accounts listget
    • Return Payoff Calculationpost
    • Returns one or more contacts matching the given criteria.get
    • Return contact informationget
    • Returns card informationget
    • Deactivate a card and give it a new statuspost
    • Inform when a card needs to be activatepost
    • Lock a cardpost
    • Unlock a cardpost
    • Returns contact cards listget
    • Returns account upcoming paymentsget
    • Transfers between accountspost
    • Verify a destination accountpost
    • Transfers between accountspost
    • Transfers between accountspost
    • Enable users to cancel various types of payments, including personal checks, before they are processed.post
    • Create a new endpoint for Travel Notifications with the necessary parameters for the different banking connectorspost
    • Returns check statuspost
    • request the issuance of a replacement cardpost
    • Set up ACH transfers from their external bank accounts to their internal accounts or loanspost
    • Enable users to generate a temporary pin for unlocking account as first step.post
    • Enable users to reset pin for unlocking account as second step.post
    • The decryption based on AES algorithmget
    • Send any type of other information back to core systempost
    • Used the card ID to query the daily limit of the cardget
    • Modify daily limit.put
    • Returns account transactionsget
  • Fallback Experience
    • Get account information regarding continuity settings activationget
    • Enables or disables fallback experienceput
    • Retrieves fallback experience settings.get
    • Sets fallback experience configuration.put
  • Proactive Outbound Client Custom Automations
    • Triggers attempt disposition eventpost
    • Triggers schedule callback created eventpost
    • Triggers callback disposition eventpost
  • Prompts API
    • Create Promptpost
    • List prompts (audio files) from Studio flowsget
    • Get a Prompt Detail by its IDget
    • Delete a Promptdel
    • Partially updates the promptpatch
    • Update a Promptput
    • Generate Download Linkget
    • Get usage of a promptget
    • Request Link to Upload Audio Filepost
    • Get prompts quotaget
    • Prompts Bulk Operationpost
    • Get the flow list by a prompt idget
  • Webhook Trigger API
    • Create a Webhook Triggerpost
    • Delete a Webhook Triggerdel
  • Industries Settings
    • Create an interaction specific configuration which can be used for all the requests of the interaction ID.put
    • Returns configurations for the provided service and roles.get
    • Returns configurations for the provided service and roles.get
  • Industries Contexts
    • Get contextget
    • Delete contextdel
    • Add context valuepost
    • Delete context valuedel
    • Update context valueput
  • Retail Experience Cloud Bridge
    • Get Customer Detailsget
    • Get Customer Ordersget
    • Get Customer Orderget
    • Update order attributespatch
    • Get Order Itemsget
    • Cancel Customer Order Itemsput
    • Change Order Shipping Addresspost
    • Cancel Customer Orderpost
    • Get order cancellation previewget
    • Get Customer Shipmentsget
    • Schedule Customer Shipmentspost
    • Get Most Recent Orderget
    • Get Shipment Available Slotsget
    • Sync cart itemsput
    • Set cart delivery addressput
    • Select cart delivery optionput
    • Bind customer to cartpost
    • Get Customer Cartget
    • Get order by cart IDget
    • Get Ordersget
    • Get Productsget
    • Get Customer Technician Visit Slotsget
    • Schedule Customer Technician Visitspost
    • Get Customer Technician Visitsget
    • Get External Customersget
    • Get Shopify Integration Credentialsget
    • Update Shopify Integration Credentialsput
    • Delete Shopify Integration Credentialsdel
    • Get Available Return Reasonsget
    • Calculate Return Refund Amountpost
    • Cancel a Returnpost
    • Create a New Returnpost
    • Request a New Return (In-Band Error Response)post
    • Get Suggested Refundpost
    • Create a Refundpost
    • Process return and create refundpost
    • Ingest recall contactspost
    • Upload recall contacts as a CSV filepost
    • Create a suppression entrypost
    • List suppression entriesget
    • Revoke a suppression entrydel
    • Check cart activity validityget
    • Search catalogpost
  • EXPRESS API
    • Get reseller contract info for an express accountget
    • Get contract actionsget
    • Create a contract action for express accountpost
    • Instantiate a Trialpost
    • Valid if account existsget
  • Industries External Entity Mapper
    • Create a mappost
    • Create a mappost
    • Search Talkdesk contact by phoneget
    • Search Talkdesk contactpost
    • Create a contactpost
    • Contact bind to an interactionpost
    • Sync a contact by integration and external IDput
  • Feedback API
    • Collect feedback datapost
  • Locations Directory
    • Get the paginated list of locationsget
    • /locations-directory/locationspost
    • /locations-directory/locationsdel
    • Get a location by idget
    • Update a location by IDput
    • Get location next week opening hoursget
    • Get the paginated list of servicesget
    • /locations-directory/servicespost
    • /locations-directory/servicesdel
    • Get the paginated list of servicesget
    • Get the paginated list of servicesget
    • Get a service by idget
    • Update a service by IDput
    • Get service next week opening hoursget
    • Get Google geo addressesget
    • Get Google geocodingget
    • Get the paginated list of service typesget
    • Search staffs by conditionsget
    • /locations-directory/staffspost
    • /locations-directory/staffsdel
    • Get a staff by idget
    • Update a staff by idput
    • Get the paginated list of specialtiesget
    • Apply a batch of LOCATION/SERVICE/STAFF/ARTICLE create, update, and delete operationspost
    • Get the paginated list of articlesget
    • Create an articlepost
    • Get an article by idget
    • Delete an articledel
    • Bulk upsert articlespost
    • Roll back a bulk-upsert runpost
    • List article typesget
    • Create an article typepost
    • Get an article type by idget
    • Update an article type's ingestion routing configpatch
    • Delete an article typedel
    • Trigger an asynchronous article ingestion from an uploaded filepost
    • Get an article ingestion jobget
    • Get a presigned download URL for an ingestion job's source fileget
    • Add or update locations, services, or staff members from a CSV filepost
  • INDUSTRIES SCHEDULER API
    • Get teams associated to an accountget
    • Get availabilities by emailpost
    • Get appointments associated to an accountget
    • Create and notify appointment via SMSpost
    • Update appointment by eventIdput
    • Delete appointment by eventIdpost
  • industries-workflows
    • List workflow schedulesget
    • Create a workflow schedulepost
    • Pause or resume a schedulepatch
    • Delete a scheduledel
    • List workflowsget
    • Start a workflowpost
    • Get a workflowget
    • Cancel or terminate a workflowpatch
    • Get workflow progressget
  • Industries Messaging Service
    • Send Messagepost
    • Send Emailpost
  • Reporting Custom Fields API
    • Publish interaction custom fieldspost
  • Queues API
    • List Queuesget
    • Assign users to queuespost
    • Unassings users to queuesdel
    • List Queue Usersget
  • Messages
    • SMS Message Deliverypost
  • Campaign Messages
    • Send Bulk Campaign Messagespost
  • Outbound Notifications API
    • Send outbound notification messagespost
  • Attributes API
    • Attributes Listget
    • Create a New Attributepost
    • Attribute Detailsget
    • Update an Attributeput
    • Attribute Users Listget
    • Associate Users to an Attributepost
    • Remove Association of Users to an Attributedel
    • Attributes Categories Listget
    • Create a New Attribute Categorypost
    • Delete an Attribute Categorydel
    • Update an Attribute Categorypatch
    • User Attributes Listget
  • Apps API
    • Get the list of appsget
    • Submit apppost
    • Get information about an appget
    • Partially updates the app infopatch
    • Get information about installationget
    • Get installation enabled usersget
    • Set the state of the installationpost
    • Get installation subscriptionget
    • Get the installation trial informationget
    • Rotates the installation's credentialspost
    • Acknowledge installation credentialspost
  • Authentication
    • Terminates all of the user's sessionspost
  • Events API
    • Get event validation public keyget
  • Callback API
    • Request a new direct callbackpost
  • Recordings API
    • Get call recordings listget
    • Delete a recordingdel
    • Get recording detailsget
    • Redirect to the recording fileget
  • Contacts API
    • Get contacts listget
    • Get a contact by idget
    • Delete a contact by iddel
    • Get a list of contact's integrationsget
    • GDPR contacts by dates, list of phones or emails, tags, or contact idspost
  • Flows API
    • Execute published flowpost
  • Campaign Management API
    • Get Entry Detailsget
    • Update a Single Entrypatch
    • Delete an Entrydel
    • List Entriesget
    • Create an Entrypost
    • Update Multiple Entriespatch
    • Bulk Delete Entriesdel
    • Create a Do Not Call Listpost
    • List Do Not Call Listsget
    • Get Do Not Call List Detailsget
    • Create or Duplicate Campaignpost
    • List Campaignsget
    • Get Campaign Detailsget
    • Delete Campaigndel
    • Update Campaignpatch
    • List Campaign Do Not Call Listsget
    • Assign Do Not Call Listspost
    • Dissociate Do Not Call Listsdel
    • List Campaign Record Listsget
    • Assign Record Listspost
    • Dissociate Record Listsdel
    • List Campaign Usersget
    • Assign Users to Campaignpost
    • Dissociate Usersdel
    • List Campaign Numbersget
    • Assign Numbers to Campaignpost
    • Dissociate Numbersdel
    • Search Entriespost
  • Record Lists API
    • List Record Listsget
    • Create a Record Listpost
    • Get Record List Detailsget
    • Update Record List Statuspatch
    • Get Record Detailsget
    • Delete a Recorddel
    • Update a Recordpatch
    • Get a List of Recordsget
    • Create a Recordpost
    • Delete Records by Phone Numberdel
    • List Record Timezonesget
    • Delete External Recordsdel
    • Create Multiple Recordspost
    • Update Multiple Recordspatch
    • Bulk Delete Recordsdel
    • Create Upload Requestpost
    • Update Upload Requestpatch
  • Identity API
    • Get activitiesget
    • Get an email address validationget
    • Get an email address validation statsget
    • Get an IP address validationget
    • Get a phone number validation dataget
    • Get a phone number validation dataget
    • Deletes the contact's enrollment informationdel
    • Creates a new contact enrollmentput
    • Provides a contact's consent for voice biometrics authenticationget
    • Changes a contact's consent for voice biometrics authenticationput
  • Schedule Event Import API
    • Bulk import agent schedule events from CSVpost
    • Get schedule import status and error report URLget
  • Scheduled Time Off API
    • A time off is deleted by an external servicedel
    • A time off is updated by an external servicepatch
    • A time off is created by an external servicepost
    • Retrieve agent schedule as iCalendarget
  • Live API
    • Subscribe to a New Streampost
    • Get subscriptionget
    • Connect to the subscription streamget
    • Update query from subscriptionput
    • List available queriesget
  • Explore API
    • Get report jobs by typeget
    • Creates a new report jobpost
    • Get job report execution detailsget
    • Cancel a report jobpost
    • Get job report execution resultget
    • Delete a reportdel
  • Guardian API
    • Get all session logs odataget
    • Get all casesget
    • Get all usersget
    • Get user by id.get
    • Get user role changesget
    • Get call quality metricsget
  • Users API
    • Get list of usersget
    • Get user detailsget
    • Set external_id of user from integrationpost
    • Get user info (OpenID Connect)get
    • Pause a recording given a contactpost
    • Start a recording given a contactpost
  • SCIM API
    • Get Usersget
    • Create Userpost
    • Delete Userdel
    • User Detailsget
    • Update partial User's attributespatch
    • Update User's attributesput
    • Get Groupsget
    • Group Detailsget
    • Get Service Provider Configurationsget
    • Get Service Provider's Resource Typesget
    • Get Service Provider's User Resource Typeget
    • Get Schemasget
    • Get Schema by IDget
  • Usage-Manager API
    • Get account wallet listget
    • Get single account walletget
    • Get all bucket configurations of an account.get
  • Case API
    • Creating a casepost
    • Deleting cases softlydel
    • Getting a list of casesget
    • Getting case detailsget
    • Updating a casepatch
    • Getting newest case details by contactget
    • Deleting cases permanentlydel
    • Update a case notepatch
    • Getting a list of case fieldsget
  • Bulk Import API
    • Get list of importsget
    • Create a new importpost
    • Get an importget
    • Updates one importpatch
    • Get a CSV file containing errorsget
    • Get the outputs of an exportget
  • Omnichannel API
    • Start recording for ongoing interactionpost
    • Pause recording for ongoing interactionpost
  • WFM Request Management API
    • create or update the Time off balance.put
    • A time off balance is deleted by an external servicedel
  • Financial Services Experience Cloud for Insurance
    • Create and publish an event to the automated-notifications system.post
    • Get accounts from a search criteriaget
    • Get account with account numberget
    • Get policies from an account holderget
    • Get policy period from a policyget
    • Search policiesget
    • Get policy metadata from a policyget
    • Create a new claim through FNOLpost
    • Get billing by account holder memberget
    • Get billing details by account holderget
    • Search claims related to account holdersget
    • Get claim by idget
    • Update contact details for an accountpatch
    • Send document delivery by SMS and emailpost
    • Write contact event data back to the core systempost
    • Get claim by idget
    • Search claims related to a policyget
    • Search claims related to an accountget
  • Billing Insights API
    • Returns the collection of the accounts that are under the caller's organization.get
    • Returns a collection of products.get
    • Returns info on the account subscription.get
    • Returns a collection of invoice lines for the given accounts.get
    • Returns a collection of usage data aggregated by month.get
  • Schedule Callbacks
    • List Scheduled Callbacksget
    • Create a Callbackpost
    • Cancel a Callbackdel
    • Update a Callbackpatch
    • Get Callback Detailsget
  • HLS Providers
    • Get a patient's billing summaryget
    • Search a patient's coverageget
    • Get a patient's coverage detailsget
    • Schedule appointmentspost
    • Get future appointmentsget
    • Cancel appointmentsdel
    • Send HL7 Events.post
    • Search provider availability slots for VA returning a ProviderAvailabilityVA objectget
    • Search provider availability slots returning a list of ProviderSlot objects. Deprecated, please use `/healthcare/available-provider-slots` instead.get
    • Search provider availability slots returning a list of ProviderSlot objects.get
    • Get the balance of a patientget
    • Search suggest provider returning a list of Provider's namesget
    • Search by patients returning a PatientStudio objectget
    • Search patients returning brief information of the patientget
    • Get the patient information of a patient.get
    • Write to the HLS Providers Call Answered APIpost
    • Update Talkdesk contact by phone number with the patient information for the given interaction idpost
    • Reset Talkdesk contact by phone numberpost
    • Act (Pause or resume) call recording of specified EHR agentpost
    • Initiate call for authorized EHR agentpost
    • Outgoing SMS - EPICpost
    • Agent status sync for Epicpost
    • Send inbasket messagepost
    • Reset patient passwordpost
    • Get the jwks to be used within the header of the jwt epic oauth2 flowget
    • Search by patients on VA returning a PatientStudio objectget
    • Get the prescriptions of a patient, adapted for the VAget
    • Request a prescription refill, adapted for the VApost
    • Cancel appointments on VAdel
    • Schedule appointments on VApost
    • Search future appointments on VA returning a FutureAppointmentsVA objectget
    • Resets VA Arrays and returns patient studio information for specific interactionget
    • Get encountersget
    • Get the medication orders of a patientget
    • Appointment Confirmationpost
    • Reschedule an appointmentpost
    • Appointment Confirmationpost
    • Get service requestsget
    • Get the procedures of a patient, as public endpoint for VA usageget
    • Diagnosis API, returns diagnosis results, whether to continue asking the next question, and the content of the questionpost
    • Triage API, returns triage levelpost
    • Store interaction-specific configuration overrides.put
    • Create a case documents of a patient.post
    • Get the outstanding orders of a patient.get
    • Save intent of a patient.post
    • Get Medication Statement.get
    • Create Medication Statement.post
    • Create medication order(request).post
    • Verify patient datapost
    • Get the schedulable service requests of a patientget
    • Get patient's last known locationget
    • Get the appointment practices of a patientget
    • Get guarantor identifiersget
    • Get guarantor billing summaryget
    • Reset guarantor passwordpost
  • Data Tables API
    • /data-tablespost
    • /data-tables/{data_table_id}get
    • /data-tables/{data_table_id}/usagesget
    • /data-tables/{data_table_id}/rowsget
    • /data-tables/{data_table_id}/rowspost
    • /data-tables/{data_table_id}/rowsdel
    • /data-tables/{data_table_id}/rows/{row_id}put
    • /data-tables/{data_table_id}/rows/bulkpost
    • /data-tables/{data_table_id}/row-batchespost
    • /data-tables/{data_table_id}/metadatapatch
    • /data-tables/{data_table_id}/schemapatch
    • /data-tables/bulkpost
    • /data-tables/export/jobspost
    • /data-tables/export/jobsget
    • /data-tables/export/files/{job_id}get
    • /data-tables/{data_table_id}/rows/importpost
    • /data-tables/importpost
  • External Credentials
    • List Public Certificatesget
    • Certificates Endpoint Optionsoptns
  • Automated Notifications
    • Get Account configurationget
    • Delete Account configurationdel
    • Get Event Typesget
    • Create new event typepost
    • Get Event Type by idget
    • Update an event typeput
    • Delete a event typedel
    • Create or update Ruleput
    • Get rule by idget
    • Delete Rule by iddel
    • Get Eventsget
    • Create Eventpost
    • Get Event by idget
    • Delete Event by iddel
    • Delete Events by external iddel
    • Get Topicsget
    • Create Topicpost
    • Get Topic by idget
    • Delete Topic by iddel
    • Get Subscriptionsget
    • Upsert Subscriptionput
    • Get a subscription by idget
    • Check opt-in status with topic ids and channel.post
    • Search Interactionsget
    • Automated Notifications Bridge for webhookspost
  • Appointment scheduling service
    • Retrieve flat appointment schedulingget
    • Search physicians based on the patient's past encountersget
  • WFM
    • Upload Forecast Import from CSV filepost
    • Get Forecast Import Statusget
  • HLS Payers
    • Update contactput
    • Find Member by idget
    • Member lookup connectionsget
    • Get a claim status by its idget
    • Get a prior authorization status by its idget
    • Provider lookup connectionsget
    • Get claimsget
    • Get prior authorizationsget
  • HLS Sycurio Integration
    • HLS Providers Sycurio Integrationpost
  • Dialer Integrations
    • Get the campaign record informationget

Authentication API

  • Authentication
    • Obtain a new access tokenpost
    • Obtain a new authorization codeget
    • Obtain a service token statuspost
    • Obtains the public server JWK setget
Powered by