Webhook Connections

The system triggers a webhook for specific events, sending real-time HTTP POST requests to the configured endpoint. This enables users to automate workflows, trigger custom actions, or integrate seamlessly with other systems without manual polling.

1. On-call Switch

Automated system monitors on-call schedule rotations and sends real-time webhook notifications when transitions occur.

Go to Account → Connections → Webhook to create a webhook connection.

You will receive a response in the following format:

{
    "event_type": "oncall_change",
    "transitions": {
        "Team Name": {
            "Schedule Name": "Schedule details including on-call switch"
        }
    }
}

Example :

{
    "event_type": "oncall_change",
    "transitions": {
        "Engineering": {
            "Primary Schedule": [
                {
                    "schedule_id": "12345678-abcd-1234-efgh-987654321000",
                    "schedule_name": "Primary Schedule",
                    "team_id": "abcd1234-5678-90ef-ghij-1234567890ab",
                    "team_name": "Engineering",
                    "previous_user": {
                        "username": "user_001",
                        "first_name": "Alice",
                        "last_name": "Johnson"
                    },
                    "new_user": {
                        "username": "user_002",
                        "first_name": "Bob",
                        "last_name": "Smith"
                    },
                    "transition_time": "2025-08-11T10:00:00+00:00",
                    "layer_type": "layer",
                    "layer_name": "Layer 1",
                    "time_zone": "UTC",
                    "escalation_policies": [
                        {
                            "ep_id": "ep-12345678",
                            "ep_name": "Critical Escalation Policy"
                        }
                    ]
                }
            ]
        }
    }
}