HTTP webhook

The HTTP webhook integration lets you create custom webhooks to send data or other information to any API endpoint of your choice. This is useful for automating incident data to your organization. You can use HTTP webhooks to create a data export or trigger them with a mitigation or data export actions.

Prerequisites

• Appropriate role permissions to create and manage integrations

Configure an HTTP webhook

1. Navigate to Platform Settings > Integrations and click the HTTP integration.
2. Click Add Integration.
3. Provide the following:
   • Integration name: How the integration will appear in your HUMAN account.
   • Authentication method: Select the authentication method for sending data.
     • If you select Web application firewall (WAF), also provide allowed IPs.
   • URL: The API endpoint URL to send data to.
   • Method: The HTTP method of the endpoint.
   • Protocol: The HTTP protocol to use.
   • Provide an SSL certificate: If you select TLS, upload a CRT file of your SSL certificate.
   • Body pattern (optional): Provide a request body pattern if needed.
   • Headers (optional): Add any header names and values as needed. If any duplicate header keys are provided, the webhook will only send the later one.
4. Click Test Connection.
5. Once the test succeeds, click Save changes.

You have successfully configured an HTTP webhook. Make sure to use the integration to create a data export or trigger it with a mitigation or data export actions.