Link

Implement any application or service with Zenduty using the Webhook API Integration.

To integrate any Application’s Webhook with Zenduty, complete the following steps:

In Zenduty:

  1. To add a new API integration, go to Teams on Zenduty and click on the team you want to add the integration to.
  2. Next, go to Services and click on the relevant Service.
  3. Go to Integrations and then Add New Integration. Give it a name and select the application API from the dropdown menu.
  4. Go to Configure under your integrations and copy the Integration key generated.

In your Application/Service:

  1. To create an alert from your application, send a post request to: https://www.zenduty.com/api/events/<integration-key>/
    • Here, the integration key that was copied earlier is to be used.
  2. Add post parameters by following the table below :

    NameTypeDefaultExampleRequired
    messageStringNoneThis becomes the incident title.Yes
    summaryStringNoneThis is the incident summary.No
    alert_typeStringInfoChoices - critical, acknowledged, resolved, error, warning, info.Yes
    suppressedBooleanFalseTrue or FalseNo
    entity_idStringNoneA unique id for the alert. If not provided, the Zenduty API will create one.No
    payloadJSONNoneA JSON payload containing additional information about the alert.No
    urlsArrayNoneAn array containing JSON schema of urls related to alerts.No
  • In the headers, the Content type should be set to “application/json”
  • 'Content-Type: application/json'
  • For a more detailed explanation of the fields, click here.
  • For cURL requests:
     curl -X POST https://www.zenduty.com/api/events/[integration-key]/ -H 'Content-Type: application/json' -d '{"alert_type":"critical", "message":"Some message", "summary":"some summary", "entity_id":"some_entity_id", "urls":[{"link_url": "https://www.example.com/alerts/1234/","link_text": "Alert URL"}]}'
    

Respond to API Integration alerts faster

Looking for a better way to get real-time alerts from API Integration, setup a solid incident escalation and incident response pipeline and minimize response and resolution times for API Integration incidents?

Signup for a free trial


Copyright © 2023 Zenduty