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

# Call Connect SDK

> Use Authsignal's Call Connect SDK for Node.js.

The Call Connect SDK makes it easier to interact with our [REST API](/api-reference/call-connect-api/overview) from your server-side code.

## Installation

<CodeGroup>
  ```bash npm theme={null}
  npm install @authsignal/node
  ```

  ```bash yarn theme={null}
  yarn add @authsignal/node
  ```

  ```bash pnpm theme={null}
  pnpm add @authsignal/node
  ```

  ```bash bun theme={null}
  bun add @authsignal/node
  ```
</CodeGroup>

## Initialization

Initialize the Authsignal Call Connect client by providing your Call Connect API secret key and the Call Connect API URL for your region.
These values can be found in the Authsignal Portal under [Settings -> Call Connect](https://portal.authsignal.com/organisations/tenants/call_connect).

<CodeGroup>
  ```ts Node.js theme={null}
  import { CallConnect } from "@authsignal/node";

  const callConnect = new CallConnect({
    apiSecretKey: "YOUR_CALL_CONNECT_API_SECRET_KEY",
    apiUrl: "YOUR_CALL_CONNECT_API_URL",
  });
  ```
</CodeGroup>

## Regions

The API URLs for each region are defined below.

| Region        | API URL                             |
| ------------- | ----------------------------------- |
| US (Oregon)   | `https://us-connect.authsignal.com` |
| AU (Sydney)   | `https://au-connect.authsignal.com` |
| EU (Ireland)  | `https://eu-connect.authsignal.com` |
| CA (Montreal) | `https://ca-connect.authsignal.com` |

## Usage

### Start call

<Card title="API schema" icon="file-code" href="/api-reference/call-connect-api/start-call-connect" horizontal />

Start a Call Connect authentication session, triggering a user verification challenge based on the configured channels.

<CodeGroup>
  ```ts Node.js theme={null}
  const request = {
    referenceId: "12aec191-69cf-419c-92d9-81e7a3b017ff",
    phoneNumber: "+64271234567",
  };

  const response = await callConnect.startCall(request);
  ```
</CodeGroup>

### Finish call

<Card title="API schema" icon="file-code" href="/api-reference/call-connect-api/finish-call-connect" horizontal />

Finish an existing Call Connect authentication session.

<CodeGroup>
  ```ts Node.js theme={null}
  const request = {
    referenceId: "12aec191-69cf-419c-92d9-81e7a3b017ff",
    state: CallState.CHALLENGE_SUCCEEDED,
  };

  const response = await callConnect.finishCall(request);
  ```
</CodeGroup>