Integrate with upstream systems using Webhooks

Webhooks

Webhooks let you integrate AbuseHQ into other systems and call their API endpoints.

Once set up, Webhooks can be added to a playbook transition.

Example

If you want to push the values stored from a case, values that were retrieved by the subscriber resolver, for example, please see below:

• You can retrieve an example context for any case via a GET request to https://YOUR_COMPANY.abusehq.net/api/v1/cases/{caseId}/context

• To retrieve the subscriber values, you can either reference the full sub-object from the context by addressing it as "s.resolver_data", or you can access single values, e.g., "s.resolver_data.CustomerEmail". Make sure to add a PQL field and not a regular value to the payload list.

Slack Message Example

In Slack, create an application, and a webhook following the documentation found here: https://api.slack.com/messaging/webhooks

This should give you a webhook link that follows a pattern like this: https://hooks.slack.com/services/TXXXXXXXX/YYYYYYYYY/ZZZZZZZZ

In AbuseHQ, create an endpoint:

1. Url: https://hooks.slack.com

2. Content-Type: JSON

In AbuseHQ, create a Webhook that uses the path from above:

1. Method: POST

2. Path: /services/TXXXXXXXX/YYYYYYYYY/ZZZZZZZZ

3. A single payload field named "text" contains the message to be sent. These fields are fully templatable using liquid, the example most seen is: "New { { event.type }} created: https://YOUR_COMPANY.abusehq.net/#subscribers/{ { case.client_id}}/{ { case.case_number }}"