mutationcreateSession

createSession

Launch a new stealth browser session with optional proxy and profile configuration.

Session creation parameters. Proxy configuration. Existing profile ID to use. Time-to-live in seconds. Enable stealth mode.

Mutation

mutation CreateSession($input: CreateSessionInput!) {
  createSession(input: $input) {
    id
    status
    wsEndpoint
    proxy {
      type
      country
    }
    createdAt
    expiresAt
  }
}

Variables

{
  "input": {
    "proxy": { "type": "residential", "country": "US" },
    "ttl": 3600,
    "stealth": true
  }
}

Response

{
  "data": {
    "createSession": {
      "id": "ses_k8m2n4p6",
      "status": "active",
      "wsEndpoint": "wss://session-k8m2n4p6.sessionkit.dev",
      "proxy": { "type": "residential", "country": "US" },
      "createdAt": "2026-06-23T15:00:00Z",
      "expiresAt": "2026-06-23T16:00:00Z"
    }
  }
}