By default, if you are a workspace member with owner, admin or integrator rights, you can create a workspace API key from the Developer Space of the Universign Web Application.
However, if you are a Master Admin of a Master Account, you can create an API key for a workspace linked to your Master Account.
Note that this is only authorized for Enterprise and Integrator client categories.
To create an API key for a workspace linked to your Master Account, send a request to POST /v1/api-keys and set the workspace_id.
You need to set the Master Console API key to authenticate you request, as in the example below:
https://api.universign.com/v1/api-keys \
-H Authorization: Bearer apikey_my_master_account_apikey \
-d workspace_id=wsp_5X \
-d name=Test_API_key
workspace_id: the ID of the workspace linked to the Master Account.
Note that the API key name is optional. If not set, default value is API key created on 2026-04-14T07:04:37.458Z.
{
"object": "apikey",
"id": "apk_5X",
"created_at": "2026-04-14T07:04:37.458Z",
"name": "Test_API_key",
"token": "apikey_xxx"
}
Note that you can have up to 5 API keys per workspace.
If you delete an API key, you can no longer use to authenticate your requests.
Recommendations
- Name your API key explicitely. It will be easier for you to identify which API key can be deleted, for example.
- Copy your API key and store it in a secure place on your side. For security reasons, Universign does not store API keys in clear text.
Authentication errors
If you don’t provide an API key or provide an invalid one when authentication is required, you will receive a 401 - Unauthorized response.
If the API key you provided does not grant you access to the resource, you will receive a 403 - Forbidden response.
