---
title: "Create an interact session"
method: POST
path: "/interact"
tags: ["Interact"]
---

# Create an interact session

`POST /interact`

## Request body

- object
  - `ttl` integer — Total time-to-live in seconds for the interact session
  - `activityTtl` integer — Time in seconds before the session is destroyed due to inactivity
  - `streamWebView` boolean — Whether to stream a live view of the browser
  - `profile` object — Enable persistent storage across interact sessions. Data saved in one session can be loaded in a later session using the same name.
    - `name` string, required — A name for the profile. Sessions with the same name share storage.
    - `saveChanges` boolean — When true, browser state is saved back to the profile on close. Set to false to load existing data without writing. Multiple non-saving sessions are allowed but only one saving session at a time.

## Response `200`

Interact session created successfully

- object
  - `success` boolean
  - `id` string — The unique session identifier
  - `cdpUrl` string — WebSocket URL for Chrome DevTools Protocol access
  - `liveViewUrl` string — URL to view the interact session in real time
  - `interactiveLiveViewUrl` string — URL to interact with the interact session in real time (click, type, scroll)
  - `expiresAt` string, date-time — When the session will expire based on TTL

## Other responses

- `402` — Payment required

---

[API](https://skmtc.dev/firecrawl/apis/firecrawl-api.md) · [All operations](https://skmtc.dev/firecrawl/apis/firecrawl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firecrawl/firecrawl-api/revisions/e350fafb5a2a/schema)