# Webhook subscriptions

Section: Team settings. Part of the [API reference](https://developer.yoprint.com/reference.md). Web page: https://developer.yoprint.com/reference/webhook-subscriptions/

This page and all 8 operation pages, in 2 files: https://developer.yoprint.com/llms/webhook-subscriptions.txt (operations 1 to 6), https://developer.yoprint.com/llms/webhook-subscriptions-2.txt (operations 7 to 8)

Subscribe a URL to YoPrint events, such as a published sales order or a received payment. YoPrint signs every delivery with the subscription's secret, retries failures and keeps a delivery log. The web app calls them Webhooks.

## Operations (8)

- [Create a webhook subscription](https://developer.yoprint.com/reference/webhook-subscriptions/v1-webhook-subscription-store.md): `POST /v1/api/store/{team_slug}/setting/webhook_subscription`. Subscribes a URL to team events.
- [List webhook subscriptions](https://developer.yoprint.com/reference/webhook-subscriptions/v1-webhook-subscription-index.md): `GET /v1/api/store/{team_slug}/setting/webhook_subscription`. Returns the team's webhook subscriptions, one page at a time.
- [List deliveries for a webhook subscription](https://developer.yoprint.com/reference/webhook-subscriptions/v1-webhook-subscription-log.md): `GET /v1/api/store/{team_slug}/setting/webhook_subscription/{id}/log`. Returns the subscription's deliveries, newest first, one page at a time.
- [Show a webhook subscription](https://developer.yoprint.com/reference/webhook-subscriptions/v1-webhook-subscription-show.md): `GET /v1/api/store/{team_slug}/setting/webhook_subscription/{hash_id}`. Returns one webhook subscription with its `status` and `disable_reason`, and its signing `secret` for the team owner and members with Manage Settings.
- [Show a sample event](https://developer.yoprint.com/reference/webhook-subscriptions/v1-webhook-subscription-sample.md): `GET /v1/api/store/{team_slug}/setting/webhook_subscription/sample/{event_name}`. Builds the event YoPrint would send for `event_name`, from your team's latest matching record, without sending anything.
- [Update a webhook subscription](https://developer.yoprint.com/reference/webhook-subscriptions/v1-webhook-subscription-update-put.md): `PUT /v1/api/store/{team_slug}/setting/webhook_subscription/{hash_id}`. Changes a subscription's URL, name, events or status, and returns it.
- [Touch a webhook subscription](https://developer.yoprint.com/reference/webhook-subscriptions/v1-webhook-subscription-update-patch.md): `PATCH /v1/api/store/{team_slug}/setting/webhook_subscription/{hash_id}`. Use PUT to change a webhook subscription.
- [Delete a webhook subscription](https://developer.yoprint.com/reference/webhook-subscriptions/v1-webhook-subscription-destroy.md): `DELETE /v1/api/store/{team_slug}/setting/webhook_subscription/{hash_id}`. Deletes a subscription for good, with its delivery log.