# JENNi Webhooks API

**Canonical:** https://apis.io/apis/jennipro-com/jennipro-com-webhooks-api/  
**Provider:** JENNi — https://apis.io/providers/jennipro-com/  
**Base URL:** https://prod.jennipro.net

JENNi Webhooks API is one of 12 APIs that [JENNi](https://apis.io/providers/jennipro-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Webhook. The published artifact set on APIs.io includes an OpenAPI specification.

Signed HTTPS callbacks for the retailers you provision: `retailer.created`, `retailer.claim_link.issued`, `retailer.claim_link.consumed`, `retailer.claimed`, and `run.closed` when one of your runs reaches `closed`, plus `ping`. A signed-in partner user registers up to 5 endpoints from the portal (`/provider/v1/portal/webhooks`); JENNi POSTs each event once per endpoint as `{id, type, created_at, data}` with `X-Jenni-Event`, `X-Jenni-Delivery`, `X-Jenni-Timestamp` and `X-Jenni-Signature: v1=<hex hmac-sha256(secret, "<timestamp>.<body>")>`, retries a non-2xx after 1m, 5m, 30m, 2h and 12h, and pauses an endpoint after 5 deliveries in a row exhaust their retries. Only events for your own provider are delivered. The signing secret is shown once, at registration or rotation. Full guide: docs/webhooks.md. Ships dark behind `PARTNER_WEBHOOKS_ENABLED` (on top of `ENABLE_PORTAL_ROUTES`).

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/provider/v1/portal/webhook-deliveries/{delivery_id}/transitions` | Replay a terminal webhook delivery |
| GET | `/provider/v1/portal/webhooks` | List your webhook endpoints |
| POST | `/provider/v1/portal/webhooks` | Register a webhook endpoint |
| PATCH | `/provider/v1/portal/webhooks/{id}` | Update a webhook endpoint |
| GET | `/provider/v1/portal/webhooks/{id}/deliveries` | Recent deliveries to an endpoint |
| POST | `/provider/v1/portal/webhooks/{id}/test` | Send a test ping |
| POST | `/provider/v1/portal/webhooks/{id}/transitions` | Change an endpoint or rotate its signing secret |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/jennipro-com/openapi/jennipro-com-webhooks-api-openapi.yml

## Other JENNi APIs (11)

- [JENNi Account API](https://apis.io/apis/jennipro-com/jennipro-com-account-api/)
- [JENNi Brand portal API](https://apis.io/apis/jennipro-com/jennipro-com-brand-portal-api/)
- [JENNi Catalog API](https://apis.io/apis/jennipro-com/jennipro-com-catalog-api/)
- [JENNi Channel API](https://apis.io/apis/jennipro-com/jennipro-com-channel-api/)
- [JENNi Events API](https://apis.io/apis/jennipro-com/jennipro-com-events-api/)
- [JENNi Inventory API](https://apis.io/apis/jennipro-com/jennipro-com-inventory-api/)
- [JENNi Portal API](https://apis.io/apis/jennipro-com/jennipro-com-portal-api/)
- [JENNi Retailers API](https://apis.io/apis/jennipro-com/jennipro-com-retailers-api/)
- [JENNi Runs API](https://apis.io/apis/jennipro-com/jennipro-com-runs-api/)
- [JENNi Service API](https://apis.io/apis/jennipro-com/jennipro-com-service-api/)
- [JENNi Stores API](https://apis.io/apis/jennipro-com/jennipro-com-stores-api/)

## Tags

Webhook

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/jennipro-com/jennipro-com-webhooks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/jennipro-com/.