> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# EmailBison: Generate Headless Uitokenbeta

> Generate a short-lived token to embed EmailBison's email account connection screen in your app. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Generate a short-lived token to embed EmailBison's email account connection screen in your app.

> [!NOTE]
>
> 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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'emailbison_generate_headless_uitokenbeta',
  {},
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute emailbison_generate_headless_uitokenbeta --input '{}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": "example"
}
```

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](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.

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "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 flows for OAuth.",
    "properties": {},
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `string` | Yes | — | Provider response payload. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "string",
        "description": "Provider response payload."
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

* [EmailBison provider guide](https://deepline.com/docs/providers/emailbison/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.