---
title: "Create tunnel session"
method: POST
path: "/api/v1/tunnels"
tags: ["Tunnels"]
---

# Create tunnel session

`POST /api/v1/tunnels`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/api/v1/tunnels`
- Auth: HTTP bearer

Creates a new tunnel session for CLI use. The tunnelToken is returned only once.

## Query parameters

- `localPort` integer, required
- `projectId` string, uuid
- `clientInfo` string

## Response `200`

OK

---

[API](https://skmtc.dev/railhook/apis/railhook-api.md) · [All operations](https://skmtc.dev/railhook/apis/railhook-api/llms.txt) · [OpenAPI document](https://skmtc.dev/railhook/apis/railhook-api/revisions/4e2c76dfc33d?raw)
