If you are a Master Admin of a Master Account, you can create a workspace (via the Universign API) that is automatically linked to your Master Account.
Before you can create a workspace, the following requirements need to be met:
- a Master Console API key to authenticate your workspace creation request.
- a Predefined plan configured on your Master Account. For more details about Predefined plans, contact your account manager at Universign.
Note that all client categories (Entreprise, Integrator or Reseller) are authorized to create workspaces via API.
To create a workspace, send a request to POST /v1/master-accounts/{msa_id}/workspaces and set the required arguments.
You need to set the Master Console API key to authenticate you request, as in the example below:
https://api.universign.com/v1/master-accounts/msa_xWnG73YLDbYA/workspaces \
-H Authorization: apikey_my_master_account_apikey
-d name=MyWorkspace \
-d [email protected] \
-d owner.name=John DOE \
-d plan.workspace_template_plan_id=wtp_ddX4WZQ82Xky
{msa_id}: the ID of the Master Account (to be retrieved from your Master Console).name: the name of the workspace to create.owner.email: the email of the workspace owner.owner.name: the name of the workspace owner.plan.workspace_template_plan_id: the ID of the Predefined plan referenced in the Master Account.
The API returns a workspace object as follows:
{
"object": "workspace",
"id": "wsp_aZw9YqJxzvno",
"name": "MyWorkspace",
"external_name": "myworkspace705",
"size": 1,
"active_members": 0,
"owner": {
"name": "John DOE",
"email": "[email protected]"
},
"company": {},
"creation_date": "2026-04-16T15:25:37.013Z",
"authorized_redirect_urls": [],
"authorized_upload_urls": [],
"entitlements": {
"plan": "custom_plan",
"template_plan_id": "wtp_ddX4WZQ82Xky",
"template_plan_name": "MY_TEMPLATE_PLAN",
"billed": false,
"current_month_end_date": "2026-05-16T15:25:37.013Z",
"started_at": "2026-04-16T15:25:37.013Z",
"ends_at": "2031-04-16T15:25:37.013Z",
"limits": {
"member": 10,
"transaction": 10,
"template": 50,
"folder": -1
},
"enabled_features": {
"identity_prevalidation": false,
"sign_without_authentication": false,
"level3_signature_dro": false,
"shared_contacts": true,
"level2_signature": true,
"manual_validation": false,
"deactivate_signed_documents_email": false,
"label_field": false,
"automatic_field": false,
"sso": true,
"action_book": false,
"level3_signature_pvid": false,
"extended_archiving_system": false,
"radiobutton_field": false,
"checkbox_field": false,
"bulk_sending": false,
"can_download_signed_document_without_extension": false,
"send_registration_url_with_token": false,
"custom_consents": false,
"only_ivsign_store": false,
"electronic_archiving_system": false,
"vialink_capture": false,
"custom_seal_label": false,
"sign_with_email_otp": false,
"can_access_action_page_without_email_verification": false,
"optional_consents": false,
"template": true,
"consumption_report": false,
"timestamping": false,
"initials_field": false,
"image_field": false,
"can_disable_signed_documents_mail": false,
"unknown_participant": false,
"can_access_action_page_without_email_verification_all_signature_levels": false,
"instant_messaging": true,
"level4_qualified_signature": false,
"standalone_seal": false,
"text_search": false,
"waiting_period": false,
"big_files": false,
"signature_validation": false,
"namirial_lta": false,
"list_field": false,
"issuers": false,
"web_identity": false,
"upload_from_url": false,
"text_field": false,
"developer": true,
"optional_document_reading": false,
"custom_signature_image": false,
"long_term_transactions": false,
"capturing_document": false
},
"allowed_lpcs": {
"level2": -1,
"level3": -1,
"level4": -1
}
},
"master_account_link": {
"id": "msa_xWnG73YLDbYA",
"status": "linked"
},
"folders_size": 1,
"authorized_urls": []
}
