Skip to main content

Webhooks

Receive real-time notifications when orbital events occur, including conjunctions, anomalies, and pattern detections.
Status: Coming Q1 2026 — Request early access to be notified when available.

Overview

Webhooks deliver events to your application in real-time:
  • Conjunction alerts — New conjunctions or risk level changes
  • Pattern detections — Maneuvers, anomalies, proximity events
  • Satellite updates — Status changes, new TLE data
  • System events — API maintenance, data source updates

Quick Start

Event Types

Conjunction Events

Pattern Events

Satellite Events

Webhook Payload

All webhook payloads follow this structure:

Verifying Webhooks

Verify webhook signatures to ensure authenticity:

Managing Webhooks

List Webhooks

Update Webhook

Delete Webhook

Test Webhook

Send a test event to verify your endpoint:

Filtering Events

Filter events to specific satellites:
Filter by risk level:

Retry Policy

Failed webhook deliveries are retried with exponential backoff: After 6 failed attempts, the webhook is disabled and you’ll receive an email notification.

Best Practices

Return a 2xx response within 30 seconds. Process events asynchronously if needed.
Events may be delivered more than once. Use the event id to deduplicate.
Always verify the X-RotaStellar-Signature header to ensure authenticity.
Webhook endpoints must use HTTPS for security.

Next Steps

Conjunction Analysis

Learn about conjunction events

Pattern Detection

Learn about pattern events