---
updatedAt: 2026-10-09T20:22:49.000Z
agentTools:
  projectIndex: https://docs.vizionapi.com/llms.txt
---

# Webhooks

Automatically receive tracking updates as soon as they are available.

Webhooks are a powerful method of automating use cases and improving productivity. Simply put, data is sent from one system to another in response to a triggering event. [This article](https://requestbin.com/blog/working-with-webhooks/) provides an in-depth webhook walkthrough if you are not yet familiar with the topic.

Where a static API provides read operations, webhooks provide dynamic resources. They allow your systems to react to events as soon as they occur, eliminating the need for polling or retrieving data at specified intervals.

## Enabling webhooks

When [creating a reference](https://docs.vizionapi.com/reference/reference_create) include a valid `callback_url`.

Vizion will begin periodically checking for updates. When new tracking data is available, Vizion API will send an update via HTTP [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST) to the provided `callback_url` parameter.

If the `callback_url` has been excluded, the update payloads must be fetched from the [GET reference updates](https://docs.vizionapi.com/reference/reference_updates_list) endpoint.

## Disabling webhooks

You must [unsubscribe the reference](https://docs.vizionapi.com/reference/reference_deactivate) associated with the updates in question. If you do not unsubscribe and are not using our [auto-unsubscribe](https://docs.vizionapi.com/docs/auto-unsubscribe) feature, Vizion will continue to send updates to the callback\_url provided.

## Best practices

Review the following practices to ensure your webhooks remain secure and functional.

### Respond to a webhook POST

Returning any [`2XX` HTTP response code](https://docs.vizionapi.com/reference/status-codes) will inform Vizion that your system successfully received the update; any other response — or a connection failure — will be handled as a failure and retried at the [next scheduled interval](https://docs.vizionapi.com/docs/configurable-tracking-frequency).

### Verify events sent from Vizion

Vizion sends webhook events from a set list of IP addresses, only trust events from [these IP addresses](https://docs.vizionapi.com/reference/ips#vizion-domain-ip-addresses).

Verify the [HMAC signature](https://docs.vizionapi.com/reference/authentication#webhook-authentication) to confirm that the received event is from Vizion.

## Enterprise webhook authentication

Vizion can support industry-standard authentication for [Pro plan](https://docs.vizionapi.com/docs/plans) customers. For further assistance, please [contact support](https://share.hsforms.com/1B6wNyBBSR6uMotj--8Z_0Q56czk).

## Development callback\_url

We recommend using a tool like [webhook.site](https://webhook.site) to generate a usable `callback_url` for testing purposes only. Verify that the pricing, uptime, and expiration time work for your testing purposes. We cannot verify the uptime of this third-party service.