> This page is for version v5.0.
> For other versions, use one of these documentation indexes:
> - v6.0 (default): https://docs.zip.tax/v-6-0/llms.txt
> - v5.0: https://docs.zip.tax/v-5-0/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.zip.tax/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.zip.tax/_mcp/server.

# Configure an endpoint

Endpoints are the HTTP URLs Ziptax delivers events to. You manage them from
**Develop > Events**. Make sure your account
[meets the prerequisites](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.

> **Info**
>
> 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](events) 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**.

| Level                        | What each notification carries                                           | Availability                  |
| ---------------------------- | ------------------------------------------------------------------------ | ----------------------------- |
| **State/Province** (default) | The tax authority that changed (`locality` and `code`).                  | All plans with webhook access |
| **Postal code**              | The tax authority **plus** the affected postal codes (`postalcodeList`). | **Enterprise plans only**     |

> **Info**
>
> 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](events#notification-granularity) in the Events
reference for the payload shape at each level.

## Next step

#### [Events reference](events)

See the events you can subscribe to and their payloads.

#### [Test & monitor](testing)

Send a test event to confirm your endpoint receives deliveries.