---
title: "Enter code / two-step password"
locale: en
url: https://tlg.builera.app/en/docs/reference/rest/accounts.login_submit
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Enter code / two-step password

Submit the login code or 2FA password the account owner gave you, or cancel the login. Never store or repeat these values.

Submit the login code or 2FA password the account owner gave you, or cancel the login. Never store or repeat these values.

## Overview

| Name | Value |
| --- | --- |
| Code | `accounts.login_submit` |
| Scope needed | `accounts.manage` |
| Risk | Write |
| May need confirmation | No |
| Runs as | Answers right away |
| Needs `Idempotency-Key` | No |
| Member roles allowed | `owner`, `manager` |
| In the app | Accounts → Login |

## Input fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `attemptId` | `uuid` | Yes |   |
| `kind` | `"code" \| "password" \| "cancel"` | Yes |   |
| `value` | `text` | No |   |

## Example request

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/accounts.login_submit \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"attemptId":"00000000-0000-0000-0000-000000000000","kind":"code"}'
```

## Output fields (`data`)

| Field | Type | Required |
| --- | --- | --- |
| `ok` | `true` | Yes |

## Example answer

```json
{
  "data": {
    "ok": true
  }
}
```

## Using it over MCP

Tool `accounts_login_submit` is listed on the profiles: Administration (`admin`). On other profiles, find it with `tools_search` and run it with `tools_run`.