api

  1. Call Control API: makecall returns 200 with callId vs 202 with no callId — dual device registration?

    We seem to be having inconsistent behaviour with the makecall endpoint of 3CX's callcontrol API. Sometimes it returns a 200 with a call ID and sometimes a 202 with no call ID. We're evaluating a solution for an integration using the makecall endpoint but would like to be certain about 3CX's...
  2. How can I disable a user/extension via the 3CX Configuration API?

    Hi everyone, I'm trying to disable a user/extension through an integration, but I can’t find any specific endpoint or field in the documentation. I’ve checked the "3CX Configuration API Endpoint Specification" documentation, but I only found information about deleting users (including bulk...
  3. API endpoint for country codes

    Hello, does it exist an API endpoint to manage the country code numbers?
  4. XAPI Call Log Data Report - CallId value is always '1'

    After we updated our phone system to V20 around 14/08/25, any reports retrieved via the xapi/v1/ReportCallLogData route results in a CallId value of '1'. Even if multiple call logs are returned in a single response, they all have 1. Example snippet of API response (data has been sanitised, but...
  5. Multiple API Issues: CallHistoryView Stuck on Old Data, and Null attached_data in WebSocket

    Version: Enterprise 8SC v20.0 We are in the process of integrating our application with the 3CX API and have run into several critical issues. We have successfully set up an API user (Service Principal) in the Admin Console and are able to get a Bearer token successfully. Using the token, some...
  6. 3CX AI for call transcriptions

    According to this document, one of the transcription engines available is a free "3CX AI", is there any information on this? Which, if any cloud/AI Provider does it use on the backend Where is data processed (same region as 3cx hosted instance? what about self-hosted?) Does 3cx use the call...
  7. Creating and Deleting Users via cURL in 3CX – Department Assignment Issue

    Hi everyone, I'm trying to create users in 3CX via the API using cURL. The user gets created successfully, but I noticed that it is created without any department assigned. Here’s the command I’m using: TOKEN=$(curl -sk -X POST "https://3cx.domain.tld:5001/connect/token" -H "Content-Type...
  8. ASheng

    REST API Endpoint for Live Queue Statistics (e.g., Active Call Count)

    Hello 3CX Community and Development Team, We would like to propose a new feature that we believe would be highly valuable for many partners and customers who manage call center environments. The Idea: Introduce a new REST API endpoint that provides real-time statistics for Call Queues. The...
  9. Feasibility of multiple API domains in single CRM integration

    Got an unusual scenario here, where the customer has multiple sites all on the same parent database system, but with unique sub-domains for each site. Example: site1.system.com, site2.system.com I have a script which makes the necessary calls for a single domain URL- is there a way I could...
  10. stubh

    Bulk Contact Importing Via API

    I am using the 3CX API for various things and one client asked if I can sync their contact list, via a CSV from another location. There are a few things making this difficult from just a time perspective. 1. The list of contacts is large, several thousands. 2. Contacts might be updated and do...
  11. Call Control API

    Hi All, Our goal is to create a true representation of our 3CX phone center in our end. We want to hold the data of calls in our database and later operate on it. We want a real-time representation of active/waiting calls, getting the calling phone number, as well as specific custom data, and...
  12. stubh

    API error asking for Delta Field

    I am setting up for some API requests and I keep getting an error message asking for a "delta" field value. I am able to get an auth token, and am able to make a few get requests and am seeing the expected output data, but when I make a post request, it keeps failing. I could not find anything...
  13. AshishKushwaha

    Issue with PhoneSystem.Root.MakeCall(<from>, <tonumber>) in Latest 3CX Versions

    We've been using the PhoneSystem.Root.MakeCall(<from>, <tonumber>) method successfully up to version 5.551. However, in the latest 3CX releases, we are encountering an issue. The call to the <from> extension is placed successfully, but after the call is answered, the system attempts to dial...
  14. Strange XAPI error fetching a recording

    Hi everyone, today I noticed a strange issue that seems to happen with a few rare calls, even though the recording is accessible via the 3CX hosting control panel I'm having an issue accessing that recording via the API. Normal I would query: The response: But there is a call that this...
  15. 3CX API - Creation of Ring Groups with DID and Department assignment

    Hello there, We will be configuring a Multi Tenant instance and we have setup the API access already and got some test data inputted. In looking in the API endpoint documentation I cannot see how to create Ring groups with assignment of DIDs and Departments. From the response using the Firefox...
  16. 3cx V20 API

    Hi Guys, We are busy testing the XAPI for 3cx v20. The function we want to use is the /Users/Pbx.MakeCall. When we look at the swagger doc it shows the following will return. Note the "Result" { "FinalStatus": "string", "Reason": "string", "ReasonText": "string"...
  17. WebSocket event bug?

    I'm listening to "wss://{{fqdn}}/callcontrol/ws", so far so good. The flow I'm testing is this... 101 calls 138 138 blind transfer call to 139 139 answers After some seconds 101 hangs up Here's the WebSocket events I receive... Each time I get an event, I get the participant like...
  18. arma_admin

    Get other roles than users with API

    Hi, We are trying to show logged in agents of a call queue on our own dashboard. Because we did not manage to get the loggedin agents directly from the call queue with the 3CX API we went for a diffrent aproach. Now we are reading out the status of all the users and if it is set to "Custom 1"...
  19. V20 CallControl API - DeviceId more than 50 Chars

    Hi, i would like to call follwing request in the CallControl-API (https://www.3cx.com/docs/call-control-api-endpoints/) /callcontrol/{dnnumber}/devices/{deviceid}/makecall i get an error of the deviceid For some devices (all 3CXPhone for Windows) had a device_id with a length of more then...
  20. How to use 3CX API?

    Hi I was able to get access to it, but what should I do with it next, or rather what parameters should I set where? In the specified documentation (https://www.3cx.com/docs/configuration-rest-api/), there is no sample code on how to use the received access token. Tell me, for example, how to...