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:
| Field | Value |
|---|
| Name | Authorization |
| Value | Bearer YOUR_API_KEY |
Get your API key at cloud.browser-use.com/settings.
2. Start a session
Add an HTTP Request node:
| Setting | Value |
|---|
| Method | POST |
| URL | https://api.browser-use.com/api/v3/sessions |
| Authentication | Header Auth (from step 1) |
| Body Type | JSON |
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:
| Setting | Value |
|---|
| Method | GET |
| URL | https://api.browser-use.com/api/v3/sessions/{{ $json.id }} |
| Authentication | Header 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.