Open New Tab
Browser Sessions
Open New Tab
Open a new tab in the session, optionally navigating to a URL.
POST
Open New Tab
Overview
The/browser/sessions/{id}/pages endpoint opens a new tab inside a browser session. Both body fields are optional:
- Omit
urlto openabout:blank. - Set
activate: falseto open the tab in the background without switching focus from the currently active tab.
pageId — the CDP target identifier used by /pages/{pageId}/activate and DELETE /pages/{pageId}.
Path Parameters
string
required
Browser session ID (UUID). Create via
POST /browser/sessions.Body
All body fields are optional.string
Optional URL to load in the new tab. Must use the
http or https scheme. When omitted, the tab opens to about:blank.boolean
default:"true"
When
true (default), the new tab becomes the active tab for subsequent session-scoped operations. Set false to open in the background.Example Request
Response
Success Response (201)
string
CDP target identifier of the newly-opened tab. Use this to activate or close it later.
string
Actual URL of the new tab after any redirects, or
about:blank when no URL was provided.Error Responses
Notes
- An empty body opens an active
about:blanktab. - Pass
activate: falseto open in the background — the previously active tab remains active for subsequent mouse, keyboard, navigate, content, and screenshot calls. - Store the returned
pageId— it’s the handle you pass toPOST /pages/{pageId}/activateandDELETE /pages/{pageId}.