Qoblex setup and settings
Qoblex setup and settings
Only workspace owners and admins can manage this connection. Start with an
API key from the Qoblex account that should supply this workspace’s data.
Before you start
API access must be enabled on your Qoblex account. It is available during the
free trial; after that, whether it is included or needs an add-on depends on
your plan. Check Qoblex’s API access information.
- Open Qoblex’s API page:
go.qoblex.com/r/integrations/api.
Sign in if it asks. - Choose Install if the API integration is not installed yet.
- Choose Create API key and copy the key.
Connect
- Open Settings → Integrations and choose Connect on the Qoblex
row. - Paste the API key and choose Connect.
Twelfth checks the key against your Qoblex account before it saves anything. If
Qoblex rejects the key, nothing is saved and the dialog says why. The key is
encrypted at rest and is never shown again or returned to the browser.
A workspace holds one Qoblex account. Connecting again replaces the stored
key on the same connection. That is also how you change the key.
Once connected, choose Manage to see the account and sync status. The
first pass starts immediately and can continue after you close the dialog.
See Inbound sync.
Replace the key
In Manage, use Reconnect with a new key, paste the new key and choose
Reconnect. Twelfth checks the account before saving. Connecting again
updates the credential on the workspace’s existing connection.
Disconnect
- In Twelfth, open the Manage dialog on the Qoblex row and choose
Disconnect. - In Qoblex, open the
API page and choose Revoke API key on
the key, so it stops working.
Disconnecting stops the sync and discards the stored key. Products and sales
already read stay in the workspace.
When connecting fails
“Qoblex refused the API key.” Check that you copied the whole key and that
it has not been revoked in Qoblex. Create a new key and connect again.
“Qoblex says API access is not on this account’s plan.” Check whether API
access is included or needs an add-on on your current Qoblex plan. Enable it
in Qoblex, then connect again.
“The API key is missing a permission.” The message names the permission.
Give the key that permission on the API integration in Qoblex, then connect
again.
“Paste the API key from Qoblex’s API integration.” The field was empty or
did not hold a key. Copy the key again and paste it with nothing before or after
it.
“Twelfth couldn’t reach Qoblex.” Qoblex did not answer. Try again in a
minute. If it keeps happening, contact support.
“Qoblex isn’t configured on this environment yet.” The environment cannot
store keys yet. Contact support.