Changing an endpoint is a sensitive action. If your sign-in isn’t recent, Quotable asks you to sign in again, or for a fresh code from your authenticator app. Every change is recorded in the workspace audit log. See Team and roles.
Add an endpoint
1
Open the form
Go to Settings → Webhooks and select Add endpoint.
2
Enter the URL
The URL must start with
https://, be reachable from the public internet, and contain no username or password. For example: https://example.com/hooks/quotable.3
Describe it (optional)
A short description, up to 120 characters, such as
Slack bridge. It helps teammates know what the endpoint is for.4
Pick events
Tracking run finalized is the event you can subscribe to, and it’s checked by default. See Events.
5
Pick brands
Leave All brands, including ones added later checked, or choose specific brands. The endpoint receives events only for the brands you choose.
6
Copy the signing secret
Select Add endpoint. Quotable shows the signing secret, which starts with
whsec_, once. Copy it into your receiver’s configuration, for example as QUOTABLE_WEBHOOK_SECRET. After you close the dialog, only its first characters are shown.Integration admins can only choose brands they have access to. For them the box reads Every brand you can access now: the endpoint covers the brands that admin can access when it’s created; brands added later aren’t included. Only the owner can create an endpoint that covers future brands.
Read the delivery log
Select Show deliveries under an endpoint to see its 50 most recent deliveries, newest first. Each row shows:
The endpoint itself shows when it last received a delivery, its secret prefix, and, if it was disabled, why.
Redeliver an event
Select Redeliver on any delivery that isn’t pending, whether it’s dead or was already delivered. It goes back on the queue with a fresh retry schedule, and its earlier attempts stay in the log. The eventid and X-Quotable-Delivery-Id don’t change, so your deduplication still recognizes it.
Rotate the signing secret
Rotate the secret on a schedule, or immediately if it may have leaked.1
Rotate
Select Rotate secret on the endpoint. Quotable shows the new secret once. Copy it.
2
Deploy the new secret
For the next 24 hours, every delivery is signed with both the new and the previous secret, and the endpoint shows a Rotating badge. Deploy the new secret to your receiver at any point in that window. A verifier that accepts any matching
v1= signature works with either secret.3
Done
After 24 hours, only the new secret signs deliveries.
Pause and resume
Select Pause to stop sending without losing events. New events keep queuing for a paused endpoint. Select Resume to send everything that queued up. Resume also re-enables an endpoint that Quotable disabled after 50 failed attempts in a row, and resets its failure count. See Delivery and retries.Remove an endpoint
Select Remove to delete the endpoint. It stops receiving events immediately, and its delivery log is deleted with it. This can’t be undone.Status badges
Next steps
Verify signatures
Accept both signatures during a rotation.
Delivery and retries
Retry schedule, guarantees and auto-disable.