The Clubhouse API & Outgoing Webhooks

Setting up Outgoing Webhooks

Outgoing webhooks can be used to gather organization information and integrate with external services. Once configured, events will fire to the URL(s) of your choice and can be used to create applications for various purposes, such as notifications and reporting.

How to Enable Clubhouse Webhooks

Click the gear wheel in the upper right hand corner of any Clubhouse page. Navigate to "Integrations" and click on "Webhooks."

From the Webhook dialogue, toggle the webhook integration button so it is on, and then click "Edit" to set the Payload URL and Secret.

Setting the Payload URL

You will need to set distinct URL for the webhook to send events to, it can be any URL you wish. Webhook data is sent as JSON in the POST request body. The events that are sent to the webhook are outlined in the developer documentation.

Setting A Secret

Setting a secret API token is optional, but if you chose to do so, Clubhouse will use it to create a hash signature with each payload that is passed along in the Clubhouse-Signature header. Clubhouse uses an HMAC hexdigest to compute the hash.

Please refer to our developer documentation for additional information such as webhook formats and example use cases.