Create a webhook endpoint
Receives the events of your key's business in its environment by POST, and no other business's, signed according to Standard Webhooks, with retries spaced over about three days.
Your API key, which acts for the one business it was created for: fb_sandbox_… issues in sandbox, fb_test_… in test, the tax authority's testing service, and fb_live_… in live.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
HTTPS, at a public address, in every environment: deliveries leave from Fiscalbase, so localhost or a private network would never reach your machine. To receive them while you develop, use a tunnel with a public URL.
uri1 <= itemsDefault
[ "*"]Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/webhook-endpoints" \ -H "Content-Type: application/json" \ -d '{ "url": "http://example.com" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "object": "webhook_endpoint", "environment": "sandbox", "url": "http://example.com", "events": [ "*" ], "disabled": true, "secret_hint": "string", "previous_secret_expires_at": "2019-08-24T14:15:22Z", "deliveries_24h": 0, "failed_24h": 0, "failing_since": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "secret": "string"}Send a delivery again POST
Sends the same event again, as a new delivery; the previous one stays in the log. It carries the same `webhook-id`, so if you already processed it you can discard it as a duplicate.
List webhook endpoints GET
Your key's business's endpoints in its environment, each with how many deliveries it had in the last 24 hours and how many failed. It never includes the signing secret: it is only shown when you create or rotate it.