You may want to be notified every time something interesting happens in your workspace. That’s what webhooks are for.
By default, if you are a workspace member with owner, admin or integrator rights, you can create a webhook endpoint(/docs/developer_tools/events/) from the Developer Space of the Universign Web Application.
However, if you are a Master Admin of a Master Account, you can create webhook endpoints to follow events triggered by a workspace linked to your Master Account.
Note that this is only authorized for Enterprise and Integrator client categories.
To create a webhook endpoint for a workspace linked to your Master Account, send a request to POST /v1/webhook-endpoints 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/webhook-endpoints \
-H Authorization: Bearer apikey_my_master_account_apikey
-d workspace_id=wsp_5X \
-d name=test_webhook_endpoint \
-d url=https://www.mywebhook.com \
-d event_types=["transaction.lifecycle.created", "action.opened"]
workspace_id: the ID of the workspace linked to the Master Account.name: the name of the event endpoint.url: the webhook URL (only secure URLs are accepted).event_types: the types of event you want to follow, separated by commas. For the list of all our webhookable events, visit Events.
The API returns a webhook-endpoint object as follows:
{
"object": "webhook-endpoint",
"id": "whe_5X",
"created_at": "2026-04-14T07:04:37.458Z",
"name": "test_webhook_endpoint",
"url": "https://www.mywebhook.com",
"tenant_id": "wsp_5X",
"event_types": ["transaction.lifecycle.created", "action.opened"]
}
