View as Markdown
Airtop icon

Airtop ACTION

Create Session

Create a new cloud browser session. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Airtop account once, then configure and run Create Session from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "airtop-create-session",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    airtop: { authProvisionId: "apn_xxxxxxx" },
    profileName: "Profile Name",
    saveProfileOnTermination: true,
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Session inputs
Property Type Description
profileName Profile Name string
Name of a profile to load into the session. Only letters, numbers and hyphens are allowed. See the documentation for more information
Optional
saveProfileOnTermination Save Profile on Termination boolean
If enabled, the profile will be saved when the session terminates. Only relevant if Profile Name is provided
Optional
timeoutMinutes Timeout (Minutes) integer
Number of minutes of inactivity (idle timeout) after which the session will terminate
Optional
record Record boolean
Whether to enable session recording
Optional
solveCaptcha Solve Captcha boolean
Whether to automatically solve captcha challenges
Optional
additionalOptions Additional Options object
Additional configuration parameters to send in the request. See the documentation for available parameters (e.g., proxy). Values will be parsed as JSON where applicable.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
airtop-create-session
Version
0.0.2
App
Airtop
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes