Add event handler

This panel allows you to create an event handler. Event handlers are used to capture changes in PortaBilling. When an event takes place (e.g., an account is created), the event handler retrieves the required information from PortaBilling via the API and triggers the API call in the external system to perform the action there (e.g., activate the SIM card). To see the full list of supported handlers, refer to the Supported event handlers section.

To add a new event handler, click +Event handler on the Event handlers panel, and fill in the details. To save the event handler, click Save. To save and continue editing the event handler’s details, click Save & Edit details.

Type a unique name for the event handler.

Select the type of event handler from the dropdown list. Type the event handler name fully or partially. To develop a custom integration using webhooks, select the EventSender handler, which translates internal provisioning events into outgoing HTTP POST requests to an external application.

By default, the toggle is enabled. It means that the handler is active once it’s created. Turn off the toggle if you want to create an inactive handler and enable it later.

On this page, you can subscribe the handler to events that are available for this handler type. See the list of events supported by a specific handler, such as EventSender, on the Events that ESPF handlers support page.

To find a specific event, type a specific name in the Quick search field. You can also select the event category from the list (type in a category name to find the necessary one), and select the corresponding checkboxes in the Event category field. To reset search criteria, click Default filters .

Choose a specific event, e.g., Account/New, and turn on the corresponding toggle. When the toggle is turned off for a specific event, this means that the event handler doesn't capture this event in PortaBilling.