Incident.io Integration

The incident.io integration allows Velocity to ingest incident.io incidents` events

Step 1 - Get Your Velocity Webhook Token

To begin the integration process, you’ll first need to request a Velocity webhook token. This token is essential for authenticating incoming event data sent from Incident.io to Velocity. To obtain your unique token, reach out to your Velocity point of contact or contact our support team directly. Once you have the token, keep it secure, you’ll need it in the next step.

Step 2 - Create a Webhook in Incident.io

  1. In your Incident.io dashboard, navigate to: Settings → Webhooks

  2. Click the “+ Add Endpoint” button.

  3. In the Endpoint URL field, paste the URL below (replacing <your_velocity_token> with your actual token):

https://api.velocity.tech/api/v1/webhooks/incidentio?token=<your_velocity_token>
  1. Optionally, you can add a short description, for example, “Velocity Integration”, to help identify the integration later.

  2. Under Events to Send, be sure to select both: private_incident and public_incident

  3. Finally, click “Create” to save the webhook.

Step 3 - Share the Webhook Secret with Velocity

Once the webhook is created, Incident.io will generate a Signing Secret. Please copy this secret and share it securely with the Velocity team. This secret ensures message integrity and allows Velocity to verify incoming requests.

🚀 You’re All Set

Your Incident.io integration with Velocity is now complete.

Last updated