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:
FieldValue
NameAuthorization
ValueBearer YOUR_API_KEY
Get your API key at cloud.browser-use.com/settings.

2. Start a session

Add an HTTP Request node:
SettingValue
MethodPOST
URLhttps://api.browser-use.com/api/v3/sessions
AuthenticationHeader Auth (from step 1)
Body TypeJSON
Body:
{
  "task": "Find the top 3 trending repos on GitHub today"
}
The response includes a session_id you’ll use to poll for results.

3. Poll for completion

Add a second HTTP Request node in a loop:
SettingValue
MethodGET
URLhttps://api.browser-use.com/api/v3/sessions/{{ $json.id }}
AuthenticationHeader Auth (from step 1)
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 a callback when the session completes. Configure your webhook endpoint in the dashboard, then add a Webhook trigger node in n8n to receive agent.task.status_update events when sessions finish.
This pattern works with any workflow tool that supports HTTP requests — Make, Zapier, Pipedream, or custom orchestrators.