Webhooks let PeekShot send screenshot URLs and metadata to your own systems (or tools like Zapier, Make.com, and Pabbly Connect) in real time. This guide explains how to create and manage webhooks from the Webhooks page.
Step 1: Open the Webhooks Page
From the sidebar, click Webhooks.
The Webhooks page shows a header, a list of existing webhooks (if any), and a Create Webhook button in the top right.
Step 2: Click “Create Webhook”
Click the Create Webhook button.
A modal titled Create Webhook opens, asking for a name, URL, and project selection.
Step 3: Fill in Webhook Details
In the Create Webhook modal:
Name: Enter a descriptive name such as "Sheets Integration", "Slack Alerts", or "Zapier Flow". This is required.
Webhook URL: Paste the URL provided by your integration platform (for example, a Zapier, Make.com, Pabbly, or custom endpoint URL). This is required.
Send Sample (Optional):
Click the Send icon button next to the URL field to send a sample webhook payload to your endpoint.
Use this to verify that your integration receives and logs data correctly before saving.
Step 4: Choose Projects (Optional)
Under Select Projects:
Use the dropdown to select one or more projects whose events should trigger this webhook.
Each selected project appears as a small badge that you can click to remove.
If you leave this empty, the webhook receives events from all projects.
Step 5: Save the Webhook
After filling in Name, Webhook URL, and optional project selection, click Create Webhook in the modal footer.
If creation succeeds, the modal closes and the new webhook appears in the webhooks table.
Step 6: Understand the Webhook List
In the webhooks table you’ll see, for each webhook:
Name: The friendly name you provided.
URL: The target webhook URL (truncated with a tooltip and copy button).
Projects: Either specific project names or "All Projects".
Status: A toggle and badge indicating Active or Inactive.
Created: The creation date and time.
Actions: A delete button for removing the webhook.
Step 7: Activate, Deactivate, or Delete a Webhook
Activate / Deactivate: Use the toggle in the Status column to turn a webhook on or off. When inactive, it stops receiving events but remains in your list.
Delete: Click the trash icon in Actions to open a confirmation dialog. Confirm to permanently remove the webhook.
What Events Does the Webhook Receive?
When PeekShot finishes generating a screenshot for a project that matches your webhook configuration, it sends an HTTP POST request with:
The screenshot URL
Metadata such as project, timestamps, and status
Other details useful for your automation workflow
You can use this data to automatically:
Add rows to Google Sheets
Upload to Airtable or databases
Post to Slack or other communication tools
Trigger additional automation flows in Make.com, Zapier, or Pabbly
Best Practices for Webhooks
Test with sample payloads: Use the Send Sample Webhook button before saving to ensure your endpoint is configured correctly.
Use HTTPS: Always use secure HTTPS URLs for your webhook endpoints.
Filter by project: If you have many projects, create separate webhooks per project to keep data organized.
Handle retries: Design your endpoint to be idempotent and resilient to duplicate messages or retries.