Skip to main content
Browser Use works with n8n as a standard HTTP integration — no custom nodes needed.

​
1. Create a credential

In n8n, go to Credentials → Add Credential → Header Auth and set: Get your API key at cloud.browser-use.com/settings.

​
2. Start a session

Add an HTTP Request node: Body:
The response includes an id you’ll use to poll for results. Save it in your workflow so later nodes can still reference this session.

​
3. Poll for completion

Add a second HTTP Request node in a loop: Check the status field. The session is done when status is idle, stopped, error, or timed_out. Use an If node to loop back with a Wait node (5–10 seconds) until complete. The final response contains output with the agent’s result.

​
Event-driven alternative

Instead of polling, use Webhooks to receive status changes. Configure your webhook endpoint in the dashboard, then add a Webhook trigger node in n8n to receive V3 session.status.update events. Match payload.session_id to the id saved from the create response, then check payload.status for completion. The agent.task.status_update event belongs to V2 tasks.
Validate the signature before accepting a webhook. See the verification example; use a verified receiver in front of n8n if your workflow cannot perform that verification itself.
This pattern works with any workflow tool that supports HTTP requests — Make, Zapier, Pipedream, or custom orchestrators.