Drıftstack docs
Docs

Launch a session from a profile (what must be true first)

You might be here because: “launch does nothing” · “Choose a proxy for this profile before launching” · “why can’t I start a session” · “trial ended” · “what do I need before I can launch”

Short answer

A profile launches when: you are signed in and online; the profile has one of your saved proxies chosen (the app never picks one for you); its device is not on hold; you are under your plan’s session, profile and storage limits; the profile is not already running; and your plan is active (a trial that has ended cannot start sessions). Each failure has its own sentence.

Check first

  • Proxy: open Edit on the profile and confirm a proxy is chosen and tested.
  • Sessions tab: is this profile already running?
  • Plan: has your trial ended?

Likely causes and fixes

  1. The launch names the proxy problem — no proxy chosen, no saved proxies, or proxy deleted. See Session refused: choose one of your saved proxies (proxy_required) and Profile shows ‘proxy deleted — choose another’ and will not launch.

  2. Trial ended. The server refuses a new session for an ended trial. Choose a plan from the dashboard → Billing → Choose a plan; see Free trial has ended: sessions refused until you choose a plan.

  3. Server-side refusals: profile already running (409, see Profile already in use); device on hold (409, see Profile’s device is on hold); storage full (409, see Profile storage is full); proxy failed its live test (422); session limit (429, see Concurrent session limit reached).

  4. Team member. Launching on a team owner needs the admin role.

  5. From code. Use agentSessions.create({ profile_id, proxy_id }). The direct sessions.create / profiles.launch endpoints take the same proxy_id (a launch from a profile bound to a proxy uses that one) and are refused with 422 proxy-required without one on hosted deployments; even with one, a direct session’s step calls answer 503 driver-not-integrated there, so drive the page from an agent session.

If it still fails

Press Talk to a person in this chat (or open Help) and include the profile name, the exact sentence and your plan. To move to Starter, Pro or Team, open the dashboard → Billing → Choose a plan (self-serve). Scale and Enterprise, refunds, disputed charges and “I paid but the plan is not active” are handled by a person. Trial extensions are decided by a person.