Nomod
Get Nomod
Webhooks/Managing Webhooks

Webhooks

Managing Webhooks

This article covers how to manage a webhook after you create one. You can edit its details, rotate its signing secret, monitor event delivery, and delete it.

Editing a webhook

Update a webhook's name, URL, or selected events at any time.

  1. Go to Settings > Tools & customisations > Apps & APIs > Webhooks
  2. Select the webhook and tap Edit
  3. Update the name, URL, or selected events
  4. Tap Update

Deleting a webhook

Deleting a webhook stops all future event notifications to that endpoint. This action is permanent and cannot be undone.

  1. Go to Settings > Tools & customisations > Apps & APIs > Webhooks
  2. Select the webhook
  3. Tap Delete webhook
  4. Tap Delete to confirm

Your signing secret

Every webhook has a signing secret. Nomod uses it to sign every payload sent to your endpoint. You use it to verify that incoming requests came from Nomod and have not been altered.

To find your signing secret:

  1. Go to Settings > Tools & customisations > Apps & APIs > Webhooks
  2. Select the webhook
  3. Find the Signing secret field
  4. Tap the Copy icon to copy the secret

Your signing secret is masked by default.

Rotating your signing secret

If you suspect your signing secret has been compromised, you can generate a new one immediately. Your old secret will remain valid for 24 hours after rotation, giving your server time to update before the old key stops working.

  1. Go to Settings > Tools & customisations > Apps & APIs > Webhooks
  2. Select the webhook
  3. Find the Signing secret field
  4. Tap the rotate icon
  5. Review the confirmation prompt and tap Generate to confirm

Copy your new signing secret and update your server code within 24 hours. After this window, the old secret expires, and any requests still using it will fail. See Verifying Webhook Signatures to learn more about protecting your endpoints from fake payloads.

Viewing event logs

To view events for a specific webhook:

  1. Go to Settings > Tools & customisations > Apps & APIs > Webhooks
  2. Select the webhook
  3. Tap the Events tab

To view events across all your webhooks:

  1. Go to Settings > Tools & customisations > Apps & APIs > Webhooks
  2. Tap the Events tab

Getting event details

Tap any event in the list to open its detail view. You will see:

  • The event name and timestamp
  • The delivery status, integration type, Event Log ID, Webhook ID, and Webhook URL
  • The full event payload in JSON format

To save the event data, tap Copy or Download to export it as a JSON file.

To create a webhook, see How Webhooks Work.

Nomod