Skip to content

Webhook subscriptions

Open .md

API reference Team settings

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.

Learn more: Receive webhooks

8 operations

  • POSTCreate a webhook subscription/v1/api/store/{team_slug}/setting/webhook_subscriptionSubscribes a URL to team events.
  • GETList webhook subscriptions/v1/api/store/{team_slug}/setting/webhook_subscriptionReturns the team's webhook subscriptions, one page at a time.
  • GETList deliveries for a webhook subscription/v1/api/store/{team_slug}/setting/webhook_subscription/{id}/logReturns the subscription's deliveries, newest first, one page at a time.
  • GETShow a webhook subscription/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.
  • GETShow a sample event/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.
  • PUTUpdate a webhook subscription/v1/api/store/{team_slug}/setting/webhook_subscription/{hash_id}Changes a subscription's URL, name, events or status, and returns it.
  • PATCHTouch a webhook subscription/v1/api/store/{team_slug}/setting/webhook_subscription/{hash_id}Use PUT to change a webhook subscription.
  • DELETEDelete a webhook subscription/v1/api/store/{team_slug}/setting/webhook_subscription/{hash_id}Deletes a subscription for good, with its delivery log.