NexusAI Webhooks

⚙️ Endpoint Setup

Webhook URL

🔗

Signing Secret

🔐

Used to HMAC-SHA256 sign all payloads. Never share this publicly.

Subscribe to Events

✓model.training.completed ✓model.inference.requested ✓dataset.processed ✓alert.triggered ✓billing.cycle.started ✓user.session.created

🧪 Test & Debug

Send a test payload to verify your endpoint configuration and routing.

--:--:-- Awaiting test request...

📦 Payload Structure

                        
// POST /webhook
// Content-Type: application/json
{
  "id": "evt_8x9f2k1m4p7q3r6t",
  "type": "model.training.completed",
  "timestamp": "2025-08-24T14:32:10Z",
  "api_version": "v3.0",
  "data": {
    "model_id": "mdl_nexus_v3_ultra_7f2a",
    "status": "success",
    "metrics": {
      "accuracy": 0.9842,
      "loss": 0.021,
      "epochs": 15
    },
    "deployment_ready": true
  }
}
                    

🛡️ Security & Verification

NexusAI signs every webhook using HMAC-SHA256 with your signing secret.

// Verify signature
const sig = req.headers['x-nexus-signature'];
const payload = JSON.stringify(req.body);
const valid = crypto
  .createHmac('sha256', SECRET)
  .update(payload, 'utf8')
  .digest('hex') === sig;
                    

⚠️

Best Practices

Always verify signatures server-side. Implement idempotency keys to handle retries. Drop < 200/299 responses within 5 seconds.

Webhook Configuration

Best Practices