← API Reference
Provider Guide

LINE authorization

LINE only supports QR code login. The QR URL and PIN are delivered asynchronously via webhooks rather than synchronously in the API response.

qrcode

LINE QR login: the QR URL and PIN are delivered asynchronously. Listen for the account.auth.required event on your webhook, or poll /auth/session to read auth_payload.url (QR image) and auth_payload.pin.

  1. 1. POST /v1/accounts with provider=line, auth_mode=qrcode. Optionally set metadata.device_login_type (for example DESKTOPMAC).
  2. 2. POST /v1/accounts/{account_id}/auth/qr/start to ask the LINE provider to begin the login session.
  3. 3. Wait for the account.auth.required event on your webhook. The platform also caches auth_payload.url (QR image) and auth_payload.pin on the account so they can be read synchronously via /auth/session.
  4. 4. GET /v1/accounts/{account_id}/auth/session to fetch the QR URL and PIN for display, then poll qr/check.
  5. 5. On account.auth.succeeded, provider_account_ref is populated automatically. POST /v1/accounts/{account_id}/runtime/start to come online.
  • metadata.device_login_type — Optional device identifier such as DESKTOPMAC or DESKTOPWIN. Forwarded to the LINE provider when starting the QR session.

Notes

  • The QR URL and PIN do NOT come back in the qr/start response. They arrive later as account.auth.required webhook events. Poll GET /auth/session or react to webhook events to retrieve them.
  • The PIN is for caller display only — it is not submitted back to LINE. Show it next to the QR so the user can verify they are scanning the correct device.
  • On account.auth.succeeded the provider_account_ref is set automatically. The event also carries the standard profile fields (display_name, picture_url, region, status_message).