API Reference

Channels

Facebook authorization

Facebook supports Cookie session import. Import an existing authorized session through the standard authentication flow.

session

Facebook session import: prepare an authorized Cookie session and use the standard import flow.

  1. 1. Prepare an existing authorized Facebook Cookie JSON file and host it at a short-lived, controlled HTTP(S) URL the service can download.
  2. 2. POST /v1/accounts with provider=facebook and auth_mode=session. Choose a region with allocatable=true and save data.id as account_id.
  3. 3. POST /v1/accounts/{account_id}/auth/session with session_url in the request body.
  4. 4. After an authorized import, check runtime_status. Send only when running; wait and refresh while starting. If stopped, call POST /v1/accounts/{account_id}/runtime/start.
  • session_url — For Facebook, session_url is required and must point to JSON with a cookies array containing c_user, xs and datr. Import success does not establish runtime readiness.

Notes

  • Export a valid Facebook session as a JSON object with a cookies array containing c_user, xs and datr. Preserve the exported Cookie attributes. Never publish real Cookies or commit them to a repository.
  • Facebook only supports session authorization; QR and code login are not supported.