Skip to main content
POST
Save a browser configuration (viewport, locale, timezone, proxy, cookies, and fingerprint) and return a persistent profile id. No browser starts and no running quota is consumed. Use the returned id to start the browser later with POST /cloud-browsers/{id}/start, or to query, update, or delete the profile. To create and start in a single request, use POST /cloud-browsers/launch instead.
string
Optional human-readable label for this profile. Maximum 255 Unicode characters after trimming. Useful for identifying profiles in list responses and the dashboard.
object
Optional saved configuration for the browser. Defaults to {}. When provided, it must be an object (arrays and scalars are rejected). Saving a proxy here does not replace the required top-level proxy field on subsequent API key start requests.

Response

boolean
Always true on success.
string (UUID)
Persistent identifier for the new profile. Store this value; you need it for every subsequent start, stop, query, and delete call.
The Free plan allows one saved profile. Check limit from GET /cloud-browsers to see your current allowance before creating additional profiles.

Error status codes