Configure an endpoint

Add endpoint URLs and choose which events they receive
Available onProEnterprise

Endpoints are the HTTP URLs Ziptax delivers events to. You manage them from Develop > Events. Make sure your account meets the prerequisites first.

Add an endpoint

Go to Develop > Events

Open your account dashboard and navigate to the Events page.

Enter your endpoint URL

Under Webhook endpoint, enter the URL that should receive events and click Save.

Add more endpoints if needed

Repeat to add additional endpoints. Each event is delivered to every configured endpoint.

Endpoint rules

  • The URL must be a valid http:// or https:// URL. Use https:// in production.
  • An account can have at most 10 active endpoints.
  • Every event is delivered to every configured endpoint.
  • Remove an endpoint with the Remove button next to it.

Subscribed events

Choose which events your endpoints receive using the Subscribed events toggle.

Subscriptions are managed at the account level. Toggling an event on or off changes it for all of your account’s endpoints, not just one.

The currently available event is rate.updated. More event types are coming soon. See the Events reference for the full catalog and payload schema.

Granularity Level

Choose how much location detail rate.updated notifications carry using the Granularity Level dropdown under Subscribed events.

LevelWhat each notification carriesAvailability
State/Province (default)The tax authority that changed (locality and code).All plans with webhook access
Postal codeThe tax authority plus the affected postal codes (postalcodeList).Enterprise plans only

On a Pro plan with the Webhook Add-On, State/Province is the only available level. Postal code appears in the dropdown only when your account is on an Enterprise plan.

Like event subscriptions, the granularity level is managed at the account level: changing it applies to all of your account’s endpoints. See Notification granularity in the Events reference for the payload shape at each level.

Next step