---
title: "Start a focus session by focus mode name"
method: POST
path: "/external/v1/focus-session/start"
tags: ["External API (Zapier/n8n)"]
---

# Start a focus session by focus mode name

`POST /external/v1/focus-session/start`

## Request

- Base URL: `https://api.focusbear.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.focusbear.io/external/v1/focus-session/start`
- Auth: HTTP bearer

## Request body

- StartFocusSessionDto
  - `focus_mode_name` string, required: Name of the focus mode to start
  - `duration_minutes` number: Duration in minutes (default: 25)
  - `intention` string: Intention for this focus session

## Response `200`

Focus session started successfully

---

[API](https://skmtc.dev/focusbear/apis/focusbear-api.md) - [All operations](https://skmtc.dev/focusbear/apis/focusbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/focusbear/apis/focusbear-api/revisions/3a83a3b9a811?raw)