Skip to main content
Generate a short-lived token to embed EmailBison’s email account connection screen in your app.
Tool ID: emailbison_generate_headless_uitokenbeta

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

CLI

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.
Use deepline describe emailbison_generate_headless_uitokenbeta --json for the latest machine-readable contract.

Input reference

This endpoint allows the authenticated workspace user to generate a headless UI token that’s valid for up to 120 minutes. The main purpose of this token is to let partner apps generate an embedded email account connection view without having to build all the UIs and OAuth connection flows themselves. Multiple tokens can be active at a given time, but they will all expire after 120 minutes. Note: You must get your requesting URL whitelisted before embedding the iframe in your app. The user must provide a valid authentication token in the request header to access this endpoint. Once a token is generated, you can open an Iframe with the following URL format: https://your-bison-url.com/headless-ui-login?token=YOUR_HEADLESS_UI_TOKEN This will then open an app window without the navigation bar and breadcrumbs. For now, this is only recommended for enabling email account connection See the live schema below for the complete notes. This action requires no input fields.

Output reference

Standard tool result payload.

Deepline cost

  • Pricing model: fixed (per call).
  • Estimated Deepline credits: 0 per pricing unit.
  • Provider-native pricing may still exist outside Deepline credit billing.