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)

curl -X POST "https://api.notte.cc/profiles/create" \
-H "Authorization: Bearer $NOTTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "my-profile"
}'

200

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

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

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)