Zendesk Notifications

Create and manage support tickets automatically when monitors change status.

Quick Start

Zendesk integration automatically creates support tickets when monitors go down. Each incident gets its own ticket with full details.

  • Monitor Down: Creates a new ticket with error details
  • Monitor Up: Can auto-solve the ticket or leave it open
  • One ticket per incident: No duplicates or spam

Setup

Get API Token

  1. 1. Go to Zendesk Admin Center → Apps and integrations → APIs → API tokens
  2. 2. Click "Add API token"
  3. 3. Copy the token immediately (won't be shown again)

Configure in Uptime Monitor

  1. 1. Go to Contacts → Add Contact → Select Zendesk
  2. 2. Enter:
    • Subdomain: yourcompany (from yourcompany.zendesk.com)
    • Email: Your Zendesk login email
    • API Token: The token from step 1
  3. 3. Save and assign to monitors

Configuration Options

FieldRequiredDescription
SubdomainYesYour Zendesk subdomain (without .zendesk.com)
EmailYesEmail address used to authenticate with Zendesk
API TokenYesZendesk API token for authentication
PriorityNoDefault ticket priority (Low, Normal, High, Urgent)
TagsNoComma-separated list of tags to add to tickets
Auto-solve ticketsNoAutomatically solve tickets when monitors recover

What Gets Created

Ticket Contents

  • Subject: [Monitor Down] Monitor Name
  • Description: Error details, URL, region, timestamp
  • Tags: uptime-monitor, monitor-down, plus your custom tags
  • Priority: Based on your configuration

Behavior

  • One ticket per incident - no duplicates
  • Auto-solve on recovery - if enabled
  • No spam - only notifies on state changes

Tips

  • Use tags: Add environment tags (production, staging) for easy filtering
  • Set priorities: Critical monitors should create urgent tickets
  • Auto-solve wisely: Enable for non-critical monitors to reduce manual work
  • Create Zendesk views: Filter by "uptime-monitor" tag to see all monitoring tickets

SSL Certificates

Certificate expiration creates tickets with automatic priority:

  • ≤3 days: Urgent priority
  • 4-7 days: High priority
  • 8-14 days: Normal priority

Troubleshooting

Authentication Errors (401)

  • • Use your login email, not support@subdomain.zendesk.com
  • • Check API token is Active in Zendesk
  • • Subdomain should be just "yourcompany" not "yourcompany.zendesk.com"

Tickets Not Appearing

  • • Check Zendesk's suspended tickets queue
  • • Verify user has permission to create tickets
  • • Check spam filters

Duplicate Tickets

Each incident creates only one ticket. If you see duplicates, check that external_id is enabled in your Zendesk account.