# beel-es Webhooks API

**Canonical:** https://apis.io/apis/beel-es/beel-es-webhooks-api/  
**Provider:** beel-es — https://apis.io/providers/beel-es/  
**Base URL:** https://app.beel.es/api  
**Documentation:** https://docs.beel.es/

beel-es Webhooks API is one of 54 APIs that [beel-es](https://apis.io/providers/beel-es/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Webhooks. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Outbound webhook subscriptions for real-time event notifications. Register HTTPS endpoints to receive event payloads when key actions occur (e.g. VeriFactu submission accepted/rejected by AEAT). All deliveries are signed with HMAC-SHA256 (`BeeL-Signature` header). Failed deliveries are retried on a fixed schedule: 7 attempts over about 3 days (3 attempts over about 11 minutes in sandbox); a `4xx` other than `408` and `429` is not retried.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/webhooks` | Create a webhook subscription |
| GET | `/v1/webhooks` | List the webhook subscriptions |
| GET | `/v1/webhooks/{webhook_id}` | Get a webhook subscription |
| PATCH | `/v1/webhooks/{webhook_id}` | Update a webhook subscription |
| DELETE | `/v1/webhooks/{webhook_id}` | Delete a webhook subscription |
| GET | `/v1/webhooks/{webhook_id}/deliveries` | List the delivery attempts of a webhook |
| POST | `/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retry` | Retry a failed webhook delivery |
| POST | `/v1/webhooks/{webhook_id}/test` | Send a test event to a webhook endpoint |
| POST | `/v1/webhooks/{webhook_id}/secret` | Rotate the signing secret of a webhook |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/beel-es/openapi/beel-es-webhooks-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/beel-es/json-schema/beel-es-create-invoice-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/beel-es/json-schema/beel-es-create-corrective-invoice-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/beel-es/json-schema/beel-es-recurring-invoice-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/beel-es/json-schema/beel-es-patch-recurring-invoice-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/beel-es/json-schema/beel-es-update-invoice-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/beel-es/json-schema/beel-es-update-recurring-invoice-request-schema.json

## Other beel-es APIs (12)

- [beel-es Account Companies API](https://apis.io/apis/beel-es/beel-es-accountcompanies-api/)
- [beel-es Account Email Domains API](https://apis.io/apis/beel-es/beel-es-accountemaildomains-api/)
- [beel-es Account Emails API](https://apis.io/apis/beel-es/beel-es-accountemails-api/)
- [beel-es Account Imports API](https://apis.io/apis/beel-es/beel-es-accountimports-api/)
- [beel-es Account Request Logs API](https://apis.io/apis/beel-es/beel-es-accountrequestlogs-api/)
- [beel-es Accounts API](https://apis.io/apis/beel-es/beel-es-accounts-api/)
- [beel-es Account Webhooks API](https://apis.io/apis/beel-es/beel-es-accountwebhooks-api/)
- [beel-es Company API](https://apis.io/apis/beel-es/beel-es-company-api/)
- [beel-es Company Activations API](https://apis.io/apis/beel-es/beel-es-companyactivations-api/)
- [beel-es Company Branding API](https://apis.io/apis/beel-es/beel-es-companybranding-api/)
- [beel-es Company Customer Imports API](https://apis.io/apis/beel-es/beel-es-companycustomerimports-api/)
- [beel-es Company Customers API](https://apis.io/apis/beel-es/beel-es-companycustomers-api/)

## Tags

Webhooks

---

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