Welcome to Zuora Product Documentation

Explore our rich library of product information

Configure Notifications

Learn how to configure notifications to receive updates via email or webhook when Zuora incidents occur or component statuses change.

To receive updates when Zuora creates an incident, updates an incident, resolves an incident or changes a component status:

  1. Navigate to Trust Status and click the Subscribe to updates.png button on the top right.
  2. Select the type of notification you would like to receive: Email or Webhook
    • For Email notifications -

      • Click the Subscribe to email.png button.

    • For Webhook notifications -

      • You can add a webhook only after you have an email associated with it to receive notifications about the webhook. See Atlassian Documentation for more detailed information on how webhook notifications work.

      • Click Add webhook URL.png to add the URL. You can add up to 7 webhooks.

To understand the structure of a typical webhook response, review the example below:

{
  "page": {
    "id": "f70d01brn2px",
    "name": "Zuora",
    "url": "https://trust.zuora.com",
    "time_zone": "America/Los_Angeles",
    "updated_at": "2025-01-13T04:20:21.677-08:00"
  },
  "incident": {
    "id": "zg7lksnxckc9",
    "name": "Intermittent API performance degradation for a subset of tenants on NA1 Production",
    "status": "monitoring",
    "created_at": "2024-10-25T16:23:31.411-07:00",
    "updated_at": "2024-10-25T16:23:31.411-07:00",
    "monitoring_at": "2024-10-25T16:23:31.411-07:00",
    "impact": "none",
    "shortlink": "https://stspg.io/xtbw8j3hqx6q",
    "started_at": "2024-10-24T08:47:41.339-07:00",
    "page_id": "f70d01brn2px",
    "incident_updates": [
      {
        "id": "d17tnz9351gp",
        "status": "monitoring",
        "body": "We continue to monitor the performance.",
        "incident_id": "zg7lksnxckc9",
        "created_at": "2024-10-25T16:23:31.411-07:00",
        "updated_at": "2024-10-25T16:23:31.411-07:00",
        "display_at": "2024-10-25T16:23:31.411-07:00",
        "affected_components": [
          {
            "code": "fv9cbs0g91v0",
            "name": "AMERICAS - CLOUD 1 (NA1) - *.na.zuora.com - Production API",
            "old_status": "operational",
            "new_status": "operational"
          }
        ]
      },
      {
        "id": "19c4v3kfwxp4",
        "status": "monitoring",
        "body": "We have investigated an intermittent API performance degradation impacting a subset of tenants on the NA1 Production environment (na.zuora.com).\nThe impacted windows were:\n2024-10-23 9:25am to 3:16pm (Pacific)\n2024-10-24 6:09am to 6:49am (Pacific)\nMitigation measures were implemented, and the impact is resolved. We continue to monitor the performance.",
        "incident_id": "zg7lksnxckc9",
        "created_at": "2024-10-24T08:47:41.394-07:00",
        "updated_at": "2024-10-24T08:47:41.394-07:00",
        "display_at": "2024-10-24T08:47:41.394-07:00",
        "affected_components": [
          {
            "code": "fv9cbs0g91v0",
            "name": "AMERICAS - CLOUD 1 (NA1) - *.na.zuora.com - Production API",
            "old_status": "operational",
            "new_status": "operational"
          }
        ]
      }
    ],
    "components": [
      {
        "id": "fv9cbs0g91v0",
        "name": "Production API",
        "status": "operational",
        "created_at": "2018-11-05T17:07:20.910-08:00",
        "updated_at": "2024-11-28T02:21:44.322-08:00",
        "position": 2,
        "description": "URLs/Endpoints: https://rest.na.zuora.com/ (REST API)"
      }
    ]
  }
}