cPanel Webhooks — Automating Actions in cPanel & WHM

What Can You Do with cPanel Webhooks?

• Automatically notify external systems when users create, modify, or delete accounts.
• Trigger custom scripts when new domains, email accounts, or databases are created.
• Integrate with third-party applications like billing systems or monitoring tools.
• Log or audit events in an external system for security and compliance.

How to Create a Webhook in WHM

To set up a webhook, you must use WHM's API.

For related cPanel automation topics, see Understanding the .cagefs Folder in CloudLinux and cpsrvd — cPanel Service Daemon.

Register a Webhook in WHM

Run the following command in SSH to create a webhook:

whmapi1 create_user_webhook url='https://yourserver.com/webhook-handler.php' event='Account::Create'

Replace https://yourserver.com/webhook-handler.php with your webhook URL.

This webhook will trigger every time a new cPanel account is created.

List Registered Webhooks

To see all active webhooks:

whmapi1 list_user_webhooks

This will display all registered webhooks, their URLs, and events.

Remove a Webhook

To delete a webhook:

whmapi1 delete_user_webhook url='https://yourserver.com/webhook-handler.php' event='Account::Create'

This removes the webhook from WHM.

Supported Events for Webhooks

cPanel & WHM support webhooks for various events, such as:

You can create webhooks for any of these events!

Example: Handling a Webhook Request (PHP)

If you set up a webhook, you need a script to handle the incoming request.

Create a webhook-handler.php file:

<?php
// Read webhook data
$data = json_decode(file_get_contents('php://input'), true);

// Log the webhook request
file_put_contents('webhook.log', print_r($data, true), FILE_APPEND);

// Respond to cPanel
http_response_code(200);
echo json_encode(["status" => "received"]);
?>

This logs webhook events and responds to cPanel.

Deploy this script on your server and update the webhook URL in WHM.

Summary of Webhook Management

Now you can automate cPanel tasks with webhooks!