Skip to main content
POST
Create an embed sign-in token

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app.

Body

application/json

The app user to mint for, and which of the app's surfaces to frame.

email
string<email>
required

The app user's email

target
enum<string>
default:live_site

Which of the app's surfaces to frame: live_site (the default, the published app), latest_preview (main's static build) or live_preview (the running sandbox).

Available options:
live_site,
latest_preview,
live_preview

Response

Successful Response

A single-use sign-in token, and the URL that spends it.

token
string
required

The single-use sign-in token. Already on embed_url; you don't need to send it anywhere yourself.

Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e30.sig"

expires_in
integer
required

Seconds until the token expires.

Example:

60

embed_url
string
required

The chosen surface's address with the token on it. Load it in an iframe.

Example:

"https://weekly-report.base44.app/?ott=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e30.sig"