This website uses cookies for analytics purposes.
Skip to main content
Version: SaaS

Using Webhooks to Forward Events

You can use the events API as a webhook to forward events in your Resolve Actions Express instance. This is useful in the case you record events or alerts in an outside system but want to use the automation and orchestration capabilities of Actions Express to remediate the issue.

To use webhooks with Actions Express, configure your third-party application as follows:

  1. Add the bridge URL in the following format: https://bridge.resolveactions.com/api/v1/gateway/PostMessage/<your_tenant_ID>
    Example: bridge.resolveactions.com/api/v1/gateway/PostMessage/CF73494Z-8235-4743-B623-16454715DF91
  2. Add a basic authorization header.
    The header must consist of the Events Client ID and the Events Secret Key (see Acquiring API Access Details), separated by a colon in base64 encoding.
    Example:
    "Authorization": "Basic Qjg0RjFCMEItMTBER … … … …"
    • If your connection details are as follows:
      • Events Client ID: B84F1B0B-10DF-4E4D-A748-ADEFEB47856C
      • Events Secret Key: ^J*M*YT$!MVS8AVVLXXU!@72N5L4P22Q
    • Then the header before base64 encoding will look like (note the colon separating the ID and the Key):
      B84F1B0B-10DF-4E4D-A748-ADEFEB47856C: ^J*M*YT$!MVS8AVVLXXU!@72N5L4P22Q
    • The header after base64 encoding will look like:
      Qjg0RjFCMEItMTBERi00RTRELUE3NDgtQURFRkVCNDc4NTZDOiBeSipNKllUJCFNVlM4QVZWTFhYVSFANzJONUw0UDIyUQ
  3. Create a payload in JSON format.
    The payload will be automatically parsed into variables, as long as it consists of one or two levels. Any other format input will be passed as a regular event.
    Example of a JSON payload:
    {
        "System" : "mysystem",
        "alert_type": "alert",
        "alert_status": "critical",
        "state": "down",
        "information": "test alert",
        "host": "my device",
        "classification": "my category"
    }
  4. Expect a 200 OK response.