LogoLogo
API DocsDeveloper PortalSystem StatusTry for Free
  • Quickstart Guide
    • Introduction
    • Get started as an Account Owner
    • Get started as a User
    • Glossary
    • FAQs
  • Manage Users
    • Types of Users
    • Add and Delete Users
    • Import Users
    • User Permissions - Access Controls
    • Manage Your Profile
    • Notification Rules
    • On-Call Reminder Rules
    • Change Account Owner
  • Manage Teams
    • Understanding Teams
    • Role Based Access Control
    • Owner Based Access Control
    • Create and Delete Teams
    • Add and Remove Team Members
    • Squads
    • Stakeholder Groups
  • Services
    • Adding a Service
    • Service Overview
    • Service Graph
    • Maintenance Mode
    • Alert Deduplication Rules
      • Alert Deduplication Rules
      • Incident Status Based Deduplication
      • Service Dependency Based Deduplication
      • Key Based Deduplication
    • Event Tagging
    • Alert Routing
    • Alert Suppression
    • Custom Content Templates
    • Intelligent Alert Grouping (IAG)
    • Auto Pause Transient Alerts (APTA)
    • Delayed Notifications
  • Schedules
    • Schedules (New)
      • Adding a Schedule
      • Schedules Overview
      • Who is On-Call?
      • My On-Call Shifts
      • Overrides
      • Videos: How to set up common use cases?
  • Escalation Policies
    • Create and Manage Escalation Policy
    • Round Robin & Advanced Escalations
    • Reassign an Incident
  • Notifications
    • Understanding Incident Notifications
  • Dashboards
    • Incident Management Dashboard
    • Dashboard Metrics
    • Take Bulk Actions
    • Squadcast Search
  • Incident List
    • Incident List View
    • Incident Priorities
    • Filter Incidents
    • Save Filter View
    • Merge Incidents
    • Snooze Incidents
  • Incidents Page
    • Incidents Details
    • Incident Activity Timeline
    • Communication Channels
    • Create Incident Manually
    • Incident Notes
    • Incident Watchers
    • Past Incidents
    • Additional Responders
    • Incident Summaries
    • Incident Suggestions
  • Runbooks
    • Runbooks
  • Postmortems
    • Postmortem Templates
    • Create Postmortems
    • Accessing Postmortem
  • Status Page
    • Status Page
    • Status Page Overview
    • Components and Groups
    • Issues
    • Subscribers
    • Maintenance
  • SLO Tracker
    • SLO Basics
    • Configure and Monitor your SLOs
  • Webforms
    • Webforms
  • Global Event Rulesets
    • Global Event Rulesets
  • Workflows
    • Workflows
    • Workflows Overview
    • Actions
  • Live Call Routing
    • Live Call Routing
  • Analytics
    • Analytics (New)
    • Organization Level Analytics
    • On Call Hours Per User
    • Weekly Reports
  • Integrations
    • Incident Webhook (Incident Webhook/API)
    • Outgoing Webhooks
    • ServiceNow Extension
    • Extensions
      • Jira Cloud Integration
      • Jira DC (Data Center)
      • CircleCI
      • Google Chat
      • Freshdesk
      • Freshservice
      • Asana
      • ClickUp
      • Trello
      • Zendesk
      • Hubspot
    • Alert Source Integrations (Native)
      • Admin Labs
      • Airbrake
      • Amazon EventBridge
      • Amazon GuardDuty
      • Amazon Opensearch
      • APImetrics
      • AppDynamics
      • AppSignal
      • Auvik
      • AWS CloudTrail Logs
      • AWS CloudTrail via CloudWatch
      • Amazon Cloudwatch (AWS) Integration
      • AWS CloudWatch Event Rules
      • AWS Elastic Beanstalk via CloudWatch
      • Amazon RDS (AWS)
      • Amazon SNS (AWS)
      • Azure Monitor
      • Better Uptime
      • Bitbucket
      • Bitrix 24
      • Blue Matador
      • Bugsnag
      • Buildkite
      • Checkly
      • Checkmk
      • CircleCI Integration
      • Cisco DNAC
      • Cisco Meraki
      • ClickUp Integration
      • CloudAMQP
      • Cloudflare
      • Conviva
      • CopperEgg
      • Coralogix
      • Cronitor
      • Crowdstrike Falcon
      • Datadog
      • Databricks
      • Dead Man's Snitch
      • Domotz
      • Dotcom Monitor
      • Dynatrace
      • ElastAlert
      • Elastic
      • Elecard Boro
      • Email Integration
      • Endtest
      • Errorception
      • Freshdesk Integration
      • Freshping
      • Freshservice
      • Ghost Inspector
      • GitHub Integration
      • GitLab
      • Grafana 8
      • Grafana
      • Graylog v4
      • Graylog
      • HaloPSA
      • Healthchecks
      • Heroku
      • HetrixTools
      • Honeybadger
      • Honeycomb
      • Humio
      • Hund
      • Hydrozen
      • Hyperping
      • Icinga2
      • InsightOps (LogEntries)
      • Instana
      • Intercom
      • Jenkins Integration
      • Jira Cloud Alert Source
      • Jira Server Alert Source
      • Kapacitor
      • Kentik
      • Komodor
      • Kibana
      • LibreNMS
      • Linear
      • Loggly
      • Logstash
      • Logz.io
      • ManageEngine Application Manager
      • ManageEngine Opmanager
      • Mezmo (formerly LogDNA)
      • MongoDB Atlas / Cloud Manager
      • Nagios
      • New Relic
      • Nixstats
      • NodePing
      • Observium
      • Oh Dear
      • Oracle Cloud Infrastructure
      • OSNexus QuantaStor
      • OverOps
      • Papertrail
      • Pingdom
      • Plesk 360
      • Postman
      • Postmark
      • Powercode
      • Progress WhatsUp Gold
      • Prometheus
      • PRTG Network Monitor
      • Rapid7 InsightIDR
      • RapidSpike
      • Redash
      • Redgate SQL Monitor
      • Rollbar
      • Rundeck
      • Runscope
      • Salesforce Cloud
      • Scout APM
      • Sematext
      • Sensu Go
      • Sensu
      • Sentry.io
      • Server Density
      • ServerGuard24
      • ServiceNow Integration
      • Shortcut (Clubhouse)
      • SignalFx
      • SigNoz
      • Site24x7
      • Slack
      • SolarWinds AppOptics
      • SolarWinds Observability SaaS (SWO)
      • SolarWinds Orion
      • Sonar
      • Splunk
      • Sqreen
      • Stackdriver
      • Stackify Retrace
      • StatHat
      • StatusCake
      • ServiceDesk Plus OD
      • Sumo Logic
      • Sysdig Monitor
      • Threat Stack
      • Trello
      • Twilio
      • Uptime
      • Uptime Robot
      • Uptrends
      • Wavefront
      • Zabbix 5.0
      • Zabbix 6.2
      • Zabbix
      • Zendesk Integration
      • Zoho Desk
      • Zoho Desk via Zoho Flow
      • LogicMonitor
  • ChatOps
    • Google Chat
    • Microsoft Teams
    • Slack for Incident Management
      • Using the Integration
  • Single Sign-On (SSO)
    • AWS SSO
    • Azure Active Directory SSO
    • Google SSO
    • Microsoft ADFS SSO
    • Okta SSO Integration
    • SAML 2.0 based SSO
  • Mobile App
    • Using the Mobile App
  • Terraform & API Documentation
    • Terraform Provider
    • Public API - Refresh Token
    • API Documentation
    • Getting Started with Squadcast GraphQL
      • Schedules
        • Create Schedule
        • Update Schedule
        • Delete Schedule
        • Pause Schedule
        • Get Schedules
        • Get Schedule by ID
        • Resume Schedule
        • Clone Schedule
        • Get Gaps
      • Rotations
        • Create Rotation
        • Update Rotation
        • Delete Rotation
        • Get Rotation by ID
        • Get Rotation Events by ID
      • Overrides
        • Create Override
        • Update Override
        • Delete Override
        • Get Override by ID
      • Calendar URLs
      • Who is On-Call
    • Developer Portal
    • Incident Rate Limiting
  • Managing your Squadcast Account
    • Audit Logs
    • Organizations
    • Billing FAQs
    • Deactivate your Squadcast Account
    • Delete your Squadcast Account
Powered by GitBook
On this page
  • Prerequisites
  • Add Webhooks
  • Supported Events
  • Edit Webhooks
  • Delete Webhooks
  • Communication Protocol for Webhooks
  • View Logs
  • Use Cases for Webhooks
  • Sample Webhook Payloads
  • Limitations of Webhooks

Was this helpful?

  1. Integrations

Outgoing Webhooks

Use outbound webhooks to send incident information from Squadcast into other systems

PreviousIncident Webhook (Incident Webhook/API)NextServiceNow Extension

Last updated 1 year ago

Was this helpful?

Webhooks allow you to connect a platform you manage (either an API you create by yourself or a third-party service) to a stream of future events.

Setting up a Webhook on Squadcast enables you to receive information (referred to as events) from Squadcast as they happen. This can help you avoid continuously polling Squadcast’s REST APIs or manually checking the Squadcast web/mobile application for desired information.

Note:

We also support generic incoming Webhooks for incident creation. You can find detailed information on how to use those .

Prerequisites

Only the Account Owner and Users with the Manage Webhook permission will be able to enable, disable and manage Webhooks in Squadcast.

If you do not have access to this feature, please contact your account admin to give you the right permissions.

Navigate to Settings -> Permissions and enable the checkbox under Webhooks for the desired users.

Add Webhooks

To add a Webhook,

  1. Navigate to Settings -> Webhooks

  2. Click Add Webhook. On the next screen, you will be guided through three steps. Navigate between these steps by clicking on any of the steps on the top bar.

  3. Add Webhook Details:

    1. Webhook Name: Enter the Webhook Name.

    2. Webhook Description (optional): Enter an optional description.

    3. Failure Notification Email (optional): Enter an email where you want to receive failure notifications. This is particularly helpful when you (or an administrator) would want to be notified of Webhook-related failures.

    4. URL: Enter the Webhook URL. We support the addition of multiple URL endpoints, with POST, PUT, and PATCH methods. Incident payloads will be sent to all the URL endpoints that are added.

    5. Additional Headers (optional): You can also configure additional headers. These headers will get attached to all the Webhook calls that will be made based on this configuration. Note: Content-Type: application/JSON is added by default.

    Click Save Changes, and navigate to the next step.

  4. Choose Webhook Type: Choose Webhook type (Manual or Automatic) and add configurations.

    1. Manual Webhook: Manually trigger Webhooks under incidents, on demand. Under Manual Webhook, select the teams that are authorized to access the Webhook. You can select All Teams or enter specific Teams, from the drop-down.

    2. Automatic Webhook: Automatically trigger Webhooks when the configured conditions match. To set up Automatic Webhook Configurations:

      1. Versions: Select the version from the drop-down.

        1. V1 supports limited events which are backward compatible

        2. V2 is the latest version and supports a lot more events

      2. Triggers: Select the Trigger events (conditions) for which the Webhook will be triggered.

      3. Filters: You can apply filters on top of events, based on Teams, Services, Alert Sources, Priorities, and Tags, either by having an individual expression or a combination of expressions/expression groups.

        Applying filters will allow the Webhook to be triggered only for events that match the filter.

      Click Next: Configure Payload, and navigate to the next step.

  5. Configure Payload: Configure the payload based on your selected Webhook type.

    1. Manual Webhook:

      1. Payload: You can reference your selected template payload here. You can modify the payload and validate it before saving the Webhook. You can also test the Webhook by clicking on the Test Webhook on the bottom right.

    2. Automatic Webhook: You can select between the standard Squadcast payload for all trigger events or customize the payload based on the pre-configured templates.

      1. Standard Squadcast Payload: You will find the standard payload for your selected trigger events based on the version you have selected. Note: You can only test the Webhook for the first trigger event you have selected in Step 2.

      2. Custom Payload: You can reference your selected template payload here. You can modify the payload and validate it before saving the Webhook. You can also test the Webhook by clicking on the Test Webhook on the bottom right. Note: You can only test the Webhook for the first trigger event you have selected in Step 2.

Click Save and you're done.

Important:

Squadcast uses the below IPs from which it sends Webhook requests. You may need to whitelist these IPs with your firewall to use Webhooks without any issues.

For US region: 34.148.46.58

For EU region: 35.246.154.28

Supported Events

The Webhooks that you have configured can be triggered for certain Trigger Events occurring in Squadcast.

You can choose multiple Trigger Events for a Webhook. Information is sent to the provided URLs if any of the triggers match. The following event types are available for each Webhook version:

Note:

Payloads for event types part of both versions are different for each.

Resource
Event
v1
v2

Incident

triggered

✔️

✔️

reassigned

✔️

✔️

acknowledged

✔️

✔️

resolved

✔️

✔️

Communication Channel

created

✔️

updated

✔️

deleted

✔️

Incident Notes

created

✔️

updated

✔️

deleted

✔️

starred

✔️

unstarred

✔️

Incident Tags

updated

✔️

Incident Task

created

✔️

updated

✔️

deleted

✔️

completed

✔️

uncompleted

✔️

Postmortem

created

✔️

updated

✔️

deleted

✔️

SLO-Violating Incident

created

✔️

marked false positive

✔️

unmarked false positive

✔️

spent error budget

✔️

StatusPage

updated

✔️

Note: Additional event types may be added to this list over time.

Edit Webhooks

To edit the Webhook configurations,

Navigate to Settings -> Webhooks -> Hover over any Webhook you want to edit and click Edit Webhook. It will open up to the guided three-step creation flow, where you can edit by navigating between these steps by clicking on any of the steps on the top bar.

Delete Webhooks

To delete a Webhook,

Navigate to Settings -> Webhooks -> Under more options, click Delete. You will receive a confirmation dialog prompt to confirm the deletion, click Delete.

Communication Protocol for Webhooks

A Webhook is called whenever the configured events occur in Squadcast.

A Webhook call is made using the HTTP POST method to the URL(s) that were added when the Webhook was configured, with a body that is encoded using JSON.

Squadcast expects the server that responds to the webhook to return a 2xx response code upon success. If a non-2xx response is received, Squadcast will retry the request a maximum of 3 times, over a period of time.

View Logs

To view logs for Webhook calls that have been made,

Navigate to Settings -> Webhooks -> Hover over any Webhook you want to view the logs for and click View Logs. You can view the Timestamp, Status, and Payloads for each Webhook call.

Use Cases for Webhooks

Webhooks can be leveraged in various scenarios. We have put together some common use cases.

They are:

  • Building internal custom dashboards to visualize or analyze incidents

  • Sending data to ticketing tools like Zendesk, Freshdesk, Shortcut, Asana, etc.

  • Sending events to communication apps like Slack, MS Teams, etc.

  • Alerting when a workflow is disrupted- then using the API to re-run the workflow

  • Triggering internal notification systems to alert people when incidents are created/resolved

  • Building your own automation plug-ins and tools

Note:

Sample Webhook Payloads

Limitations of Webhooks

  1. The Webhooks API provides "at least once" delivery of Webhook events. This means that an endpoint might receive the same Webhook event more than once. You should be able to handle any possible duplicates.

  2. Ordering amongst Webhooks isn't guaranteed between different topics for the same resource. For example, it's possible that an incident-triggered Webhook for a second incident might get triggered before the first incident when there are many incidents created in quick succession.

  3. Webhook delivery isn't always guaranteed. You should therefore implement reconciliation jobs to fetch data from Squadcast periodically.

Payload Templates: Select one of the pre-configured templates, or create your own payload. If you want to add more commonly used templates, create a PR on .

Note: If your use case requires more Squadcast events to be supported, please contact our with the details for the same.

Please contact our if you need help integrating your Squadcast account into a third-party application using Webhooks.

To see the sample Webhook payloads, click .

Have any questions? .

GitHub
Support team
Support team
here
Ask the community
here
Setting up Webhooks permission
Step 1: Add Webhook Details
Step 2(a): Configure Manual Webhook
Step 2(b): Configure Automatic Webhook
Step 3(a): Configure payload for Manual Webhook
Step 3(b): Configure payload for Automatic Webhook
Steps to edit a Webhook
Steps to delete a Webhook
Steps to view logs for Webhook calls
Setting up Webhooks permission
Step 1: Add Webhook Details
Step 2(a): Configure Manual Webhook
Step 2(b): Configure Automatic Webhook
Step 3(a): Configure payload for Manual Webhook
Step 3(b): Configure payload for Automatic Webhook
Steps to edit a Webhook
Steps to delete a Webhook
Steps to view logs for Webhook calls