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 “Manage” button corresponding to the team you want to add the integration to.
  2. Next, go to “Services” and click on the “Manage” button corresponding to 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 the following 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
  • 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"}'
    

Respond to API Integration alerts faster

Looking for a 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 Zenduty 2020. Product of YellowAnt