Webhooks
InstaWP let you send real-time site events from your InstaWP account to an external URL through webhooks. This helps developers, agencies, and teams connect InstaWP with their own tools, automation systems, CRMs, Slack channels, project management apps, and custom workflows.
Supported Events
InstaWP currently supports the following webhook events:
Event | Description |
|---|---|
Site Created (site.create) | Fires when a new site is created in your InstaWP account. |
Site Deleted (site.delete) | Fires when a site is deleted from your InstaWP account. |
In this documentation, we will explore the steps to:
Let’s get started 🚀
How to Create a Webhook
Step 1: Open Webhooks
Sign in to your InstaWP account to access the main dashboard. Go to Settings from the left menu and select Webhooks.
Click on the Create Webhook button. A new window will appear where you can configure your webhook.
Step 2: Choose the events you want to listen to
In this step, you can select the InstaWP events that should trigger the webhook. The available events include: site.create and site.delete.
You can select a single event or multiple events based on your workflow. You can also use the Select all events option to subscribe the webhook to all available events.
Step 3: Configure your webhook
This window allows you to configure where InstaWP should send the webhook request when the selected event occurs.
You can configure the following values:
Value | Description |
Destination Name | Add a name for your webhook so you can identify it later. |
Endpoint URL | Add the external URL where InstaWP should send the webhook request. |
Request Type | Select the request format. In the current setup, JSON is used. |
Secret Key | Optional field used to verify webhook requests. |
Description | Optional note to describe what this webhook is used for. |
Once all the details have been entered, click Continue.
Step 4: Review and Create
The final screen shows a summary of your configuration:
- Selected events
- Destination name and endpoint URL
- Request type
- Secret key status (set or not set)
- Description
Verify everything is correct, then click Create destination.
You will see a confirmation message: Webhook created successfully. Your webhook now appears in the Webhooks list.
Viewing and Managing Webhooks
Webhooks List
After creating a webhook, go to Settings → Webhooks to see all your webhooks. The list shows:
Column | What It Shows |
|---|---|
Name | The webhook name and its endpoint URL. |
Status | Whether the webhook is currently active. |
Listening To | How many events the webhook is subscribed to. |
Activity | A summary of recent webhook activity. |
Response Time | Average time your endpoint takes to respond. |
Error Rate | Percentage of failed deliveries. |
Actions | Options to edit, disable, or delete the webhook. |
Webhook Details
Click any webhook in the list to open its detail view. You will see two tabs:
➡ Overview
Overview
Displays the webhook’s configuration and performance metrics at a glance:
- Webhook status (active or inactive)
- Destination URL and selected events
- Total deliveries and error rate (e.g., 0%)
- Average response time (e.g., ~640 ms)
- Charts showing event delivery trends and response times over time
Event Deliveries
Shows a detailed log of every delivery attempt. Each row includes:
Field | What It Shows |
|---|---|
Event | Which event triggered this delivery (e.g., Site Created). |
Status | Whether the delivery succeeded or failed. |
Attempts | How many times InstaWP tried to deliver this event. |
Response Time | How long your endpoint took to respond. |
HTTP Status | The HTTP response code returned by your endpoint. |
Timestamp | The exact date and time the delivery was made. |
Common Use Cases
1. Team Notifications
Send a Slack or Discord message whenever a new staging site is created or deleted. This keeps your agency, dev team, or support team informed without manual follow-ups.
2. CRM Updates
When a demo site is created, automatically update the lead record in HubSpot, Pipedrive, Airtable, or your internal CRM. Useful for demo tracking, lead management, and WaaS sales funnels.
3. Project Management Automation
Automatically create a QA task in ClickUp, Asana, Trello, Jira, or Linear when a new site is built. This ensures every client build goes through your standard checklist.
4. WaaS and Demo Site Automation
When a user creates a demo site from a template, trigger onboarding emails, start a trial timer, and update the customer record—all automatically.
5. Site Cleanup Workflows
When a temporary demo site is deleted, mark the demo as expired in your CRM and clean up related records. Keeps your external systems in sync.
6. Developer CI/CD Triggers
Trigger a custom script after site creation that installs a plugin build, runs automated tests, or updates an internal system. Useful for plugin/theme developers and QA teams.
Summary
InstaWP Webhooks help you connect site activity inside InstaWP with the rest of your workflow. You can use webhooks to trigger automations when a site is created or deleted, notify your team, update your CRM, start WaaS workflows, create project tasks, or clean up external records.
Frequently Asked Questions
What are InstaWP Webhooks?
InstaWP Webhooks are automated HTTP requests sent from InstaWP to an external endpoint when selected site events happen.
Which events are currently supported?
The current webhook flow supports Site Created and Site Deleted events.
Can I select multiple events for one webhook?
Yes. You can select one event, multiple events, or use Select all events.
What request format does InstaWP use for webhooks?
The current setup sends webhook data in JSON format.
Is the secret key required?
No. The secret key is optional, but it is recommended for production workflows.
Where can I see webhook delivery logs?
Open the webhook from the Webhooks list and go to the Event Deliveries section.
Can I test webhooks before using them in production?
Yes. You can use a temporary webhook testing tool such as webhook.site to inspect incoming webhook requests.
Updated on: 28/04/2026
Thank you!