Skip to main content
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 url to open about:blank.
  • Set activate: false to open the tab in the background without switching focus from the currently active tab.
The response returns the new tab’s 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.
Example Response:

Error Responses

Notes

  • An empty body opens an active about:blank tab.
  • Pass activate: false to 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 to POST /pages/{pageId}/activate and DELETE /pages/{pageId}.