Webhooks
Unified Gaming. Optimized Performance.
Event Triggers
Supported Game & System Events
Configure real-time HTTP callbacks by defining your endpoint URL and selecting trigger conditions. Receive instant POST requests when players launch titles, finish synthetic benchmarks, or complete in-store transactions.
nexusplay.game.launch
Fires immediately after a title initializes. Includes executable path, DRM status, and active overlay settings. Commonly triggered for titles like Baldur's Gate 3, Starfield, and Horizon Forbidden West.
nexusplay.benchmark.complete
Dispatched when a synthetic or in-game benchmark finishes. Contains aggregate FPS, GPU thermal thresholds, and VRAM allocation. Validated against 3DMark Time Spy, Unigine Superposition, and Cyberpunk 2077 Ray Tracing modes.
nexusplay.purchase.confirmed
Triggers upon successful payment processing and license binding. Returns SKU identifiers, regional pricing, and receipt checksums. Supports NexusPlay Store direct sales and third-party key activations.
nexusplay.mod.verify
Emitted after community content passes integrity checks and injects into the virtual file system. Reports mod repository source, compatibility flags, and required runtime libraries.
Request Structure
JSON Payload Specifications
Validate incoming requests by verifying the HMAC-SHA256 signature attached to each envelope. Parse these standardized fields to route notifications into your Discord server, Slack workspace, or custom analytics pipeline.
Envelope Headers
Authorization: Bearer <webhook_secret> | X-NexusPlay-Signature: sha256=... | X-Request-ID: uuid-v4 | Content-Type: application/json. Retries follow exponential backoff up to 5 attempts over 24 hours.
User Profile Object
Contains subscriber_id, tier (Standard/Pro/Enterprise), home_region, and hardware_fingerprint. Example: uid: 8842-A7X9, region: EU-West, gpu_tier: RTX_4080.
Performance Metrics
Nested telemetry array reporting avg_frame_time_ms, cpu_utilization_percent, gpu_temperature_celsius, and active_resolution. Data is sampled at 1Hz during the final 60 seconds of the event window.
Transaction Data
Financial breakdown including currency_code, gross_amount_cents, tax_breakdown, and payment_method_id. Example: receipt_id: TXN-99283-KP, currency: USD, status: settled.