Webhooks

Understand the project Webhooks page and recover when its embedded portal is not ready.

Webhooks let another service receive selected events from a Runner project. This is an advanced, security-sensitive feature: use it only when you know which service should receive the events and how that service verifies them.

Entry path

Open the project Webhooks page only through an entry Runner makes available to your workspace. If there is no entry, do not guess a URL; see Feature availability or ask support whether the feature is enabled.

Before you start

Use Webhooks only when Runner or support exposes an approved entry.
Know the intended receiving service and how it verifies events.
Treat endpoint addresses, signing secrets, and delivered data as sensitive.

What Runner shows

Runner prepares the webhook service before it displays the embedded management portal.

Page state or control	What it means or does
Loading…	Runner is checking whether the webhook service is ready.
Webhook platform is initializing	Setup is still in progress. Wait and keep the page open, or return later.
Initialization is taking longer than expected	Setup has not completed after the normal wait. Retry asks Runner to provision the service again.
Retrying…	The retry is in progress; the button remains unavailable until the request finishes.
Error message	Runner could not prepare the service. Keep the visible message for support.
Embedded webhook portal	The service is ready. The exact labels and controls inside this provider-managed portal can change, so follow the instructions shown there rather than relying on fixed button names in this guide.
Reconnect Shopify	Opens the Shopify integration page when an older Shopify connection needs new webhook permissions. Reconnect before expecting Shopify events to arrive.

Recover from a long initialization

Wait for the initialization message to finish.
If Initialization is taking longer than expected appears, select Retry once.
Wait for the embedded portal to replace the initialization screen.
If an error appears again, save the project name and exact message, then contact support instead of repeatedly retrying.

Reconnect Shopify when asked

Read the Reconnect your Shopify store notice.
Select Reconnect Shopify.
Complete the connection flow on the Shopify integration page.
Return to Webhooks and confirm the reconnect notice is gone before relying on event delivery.

Reconnecting changes the store's integration authorization. Only a person who is allowed to manage that store connection should continue.

Security notes

Treat endpoint addresses, signing secrets, and event contents as sensitive.
Add or change a destination only when its owner has supplied the correct secure address.
Review every confirmation shown inside the embedded portal; its actions can affect future deliveries.
If a signing value is exposed, replace it in both Runner's webhook service and the receiving system before sending more events.

Troubleshooting

Problem	Next step
No Webhooks entry	The feature is not exposed in this workspace. Check Feature availability.
Initialization does not finish	Use Retry once, then report the exact state if it repeats.
Error message appears	Keep the full message and project name for support.
Shopify reconnect notice remains	Finish reconnecting from the integration page, then reload Webhooks once.
Embedded portal is blank or behaves differently	Reload once. If it persists, capture what is visible; the embedded provider interface may differ by account or release.

On This Page