Profile Create

POST /profiles/create

python

Python

from notte_sdk import NotteClient

notte = NotteClient()
# Create a new browser profile with a name
profile = notte.profiles.create(name="my-profile")
print(f"Created profile: {profile.profile_id}")
# Cleanup
_ = notte.profiles.delete(profile.profile_id)

200

{
  "profile_id": "<string>",
  "name": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "persisted_domains": [
    "<string>"
  ]
}

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-notte-request-origin · string | null

x-notte-sdk-version · string | null

Body

application/json

name · string | null

Name of the profile

Response

200

application/json

Successful Response

profile_id · string · required

Profile ID (format: notte-profile-{16 hex chars})

name · string | null · required

Profile name

created_at · string<date-time> · required

Profile creation timestamp

updated_at · string<date-time> · required

Profile last update timestamp

persisted_domains · string[]

List of domains with persisted browser state (cookies, localStorage, sessionStorage)