Setting Up a Webhook
Before you start
You'll need somewhere for Astalty to send events to — a publicly reachable HTTPS URL on your own system that accepts POST requests. See Receiving and verifying webhooks for what that endpoint needs to do.
Open the Webhooks area
- Head to the Settings menu.
- Select API Dashboard.
- Open the Webhooks tab.
Create a webhook
Select Create Webhook and fill in the form:
- Description — a short label so you can recognise this webhook later (e.g. "Sync new participants to CRM").
- URL — the HTTPS endpoint on your system that Astalty should send events to.
- Enabled — leave ticked to start receiving events immediately, or untick to set it up without activating it yet.
- Event Types — tick each event you want this webhook to listen for. You can select one, several, or all of them.
Select Create to save the webhook.
Copy your signing secret
When the webhook is created, Astalty generates a signing secret. Your system uses this secret to confirm that incoming requests genuinely came from Astalty — see Receiving and verifying webhooks. Store it securely alongside your other credentials.
Manage an existing webhook
Selecting a webhook from the list opens its detail page, where you can:
- Edit its description, URL, enabled state and subscribed events.
- Disable it temporarily by unticking Enabled — Astalty keeps the configuration but stops sending events.
- Archive it when it's no longer needed.
Review delivery logs
Each webhook keeps a log of its calls — every event Astalty has tried to deliver to it. Open a webhook to see its delivery history, and select an individual call to inspect:
- The event type and the exact payload that was sent.
- The delivery status (delivered, retrying or failed) and each attempt that was made.
- The option to retry a failed delivery manually.
For how automatic retries work, see Receiving and verifying webhooks.