Overview
⚠️ This guide applies only to 3CX v20. If you're using an alternative 3CX version, follow the 3CX CSV integration guide instead.
Before you can connect CG 3CX v20 to OneUp, you'll need to create an API application in your 3CX Admin Console.
This will generate an API key that OneUp uses to securely connect to your 3CX account.
🔒 You'll need administrator access to 3CX to complete these steps.
Generate an API key
Log in to the 3CX Web Client as an administrator.
Open Admin Console.
Navigate to Integrations → API.
Click Add to create a new client application.
If available, enable 3CX Configuration API Access.
Select the appropriate Department and Role for the service principal.
Save the application.
After the application has been created, 3CX will generate an API Key.
⚠️ The API key is only displayed once. Make sure you copy and store it somewhere secure before leaving the page.
What next?
Choose the option that applies to you:
If you're onboarding with an Implementation Engineer, send them the API Key and they'll complete the setup for you.
If you're using our self-serve setup flow, return to OneUp and enter the details when prompted.
If you're reconnecting an existing integration, follow the steps below.
Reconnecting 3CX v20
In OneUp, click the Settings icon next to your profile picture and select Platform Settings.
Select Integrations in the left-hand menu.
Find 3CX v20 and click the 🔒 icon.
Enter the API Key generated in 3CX.
Click Connect.
Check the connection
Once connected:
The integration status will show as Authenticated.
Data will begin syncing into OneUp.
Your users, activity and performance data will start appearing throughout the platform.
Troubleshooting
I forgot to save my API key
3CX only displays the API key once. Create a new API application and generate a new API key, then reconnect the integration using the new key.
My connection failed
Double-check that the API key has been copied exactly as displayed in 3CX.
My data isn't appearing in OneUp
The initial sync can take some time to complete. If the integration shows as connected but no data has appeared after 24 hours, contact our Support team.