---
title: "Create session"
method: POST
path: "/integrations/session"
tags: ["Integrations"]
---

# Create session

`POST /integrations/session`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/integrations/session`
- Auth: HTTP bearer

Creates a Nango session token for initiating the OAuth flow with a third-party integration.

The returned session token should be used with the Nango Connect UI to complete the OAuth authorization. Once authorized, the connection is automatically saved to the workspace.

## Request body

- object
  - `workspaceId` string, uuid, required: Workspace ID
  - `integrationType` string, required: Integration type to connect

## Response `200`

Session token created

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `sessionToken` string, required
      - `integrationType` string, required
      - `workspaceId` string, uuid, required

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `500`: Server error

---

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