Obvious/Help Center

Triggering a Task from a Webhook

Last updated June 19, 2026 · 3 min read

Use a webhook-triggered task when something in an external service should start a saved Obvious task automatically. The external service sends an event to Obvious, and Obvious runs the task connected to that webhook subscription.

Before you start

Make sure you have:

  • A task you want the webhook to run.

  • Access to the external service where you'll add the webhook URL, such as Salesforce, Stripe, Slack, GitHub, or Pylon.

  • Editor access in the Obvious project if you need to create or edit the task.

Create the webhook subscription

  1. Open a thread in your Obvious project, inside the task you want the webhook to trigger, or as part of setting up a new task.

  2. Ask the agent to create a webhook subscription for the external service and event type you want to listen for. For example: Create a webhook subscription for Stripe that listens for payment created events.

  3. Copy the webhook URL the agent returns.

If the external service is already connected to Obvious, the agent may handle registration automatically. In that case, you may not need to copy and paste a URL.

Add the URL to your external service

  1. Open the external service's webhook or developer settings.

  2. Add a new webhook endpoint.

  3. Paste the webhook URL from Obvious.

  4. Select the events you want the service to send.

  5. Save your changes.

The exact settings page lives outside Obvious, so the labels may differ by service.

Connect the webhook subscription to a task

A webhook subscription on its own only listens for events. To make it run work in Obvious, connect it to a task. To connect the subscription, tell the agent which task to use when creating the subscription.

For example: Create a webhook for Pylon support tickets and connect it to my "Triage New Tickets" task.

Every matching event runs the connected task with the event data included.

What happens when an event arrives

When the external service sends a matching event, Obvious receives it and starts the associated task. Each automation run gets its own thread, so you can see what the agent did, review the results, and use the thread history as the run record.

Find and review the run

After the external service sends an event, check the task's run history. Running tasks can also appear in the activity panel with live progress.

Open the run to review what happened. If the task includes an approval gate, the run may pause until someone approves or rejects it.

Troubleshooting

The subscription is not triggering. Check that the webhook endpoint is saved in the external service and that the service is sending the event type you selected. If the subscription is paused, events sent during the pause are ignored.

The run is not appearing. Confirm that the webhook subscription is connected to the task. A subscription that is not connected to a task only listens for events; it does not run anything.

The task starts but pauses. The task may be waiting on an approval gate. Open the run from your run history to approve or reject it.

You need to stop the webhook temporarily. Ask the agent to pause the subscription. To remove it entirely, ask the agent to delete the webhook subscription. Deleting a subscription disconnects it from linked tasks, but does not delete the tasks themselves.

Still stuck? Email help@obvious.ai.

Was this helpful?