> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# connect

> Transfer or connect the call to another destination.

[functionresult]: /docs/server-sdks/reference/typescript/agents/function-result

Transfer or connect the call to another destination. Generates a SWML `connect`
verb under the hood.

> **Note**
>
> When `final` is `true` (the default), the call permanently leaves the agent. When
> `final` is `false`, the call returns to the agent if the far end hangs up first.

## **Parameters**

**`destination`** `string` — required

Where to connect the call. Accepts a phone number in E.164 format (e.g.,
`"+15551234567"`) or a SIP address (e.g., `"support@company.com"`).

---

**`final`** `boolean` — default: true

Whether this is a permanent transfer.

* `true` — call exits the agent completely (terminal action)
* `false` — call returns to the agent when the far end hangs up

---

**`fromAddr`** `string | undefined` — default: undefined

Caller ID override. Phone number or SIP address to show as the caller. When
`undefined`, the current call's originating address is used.

---

## **Returns**

[`FunctionResult`][functionresult] -- `this`, for chaining.

## **Examples**

### Permanent Transfer

```typescript {4}
import { FunctionResult } from '@signalwire/sdk';

const result = new FunctionResult('Transferring you to sales.')
  .connect('+15551234567');
```

### Temporary Transfer

```typescript {4}
import { FunctionResult } from '@signalwire/sdk';

const result = new FunctionResult('Connecting you to a specialist.')
  .connect('+15551234567', false);
```

### Custom Caller ID

```typescript {4}
import { FunctionResult } from '@signalwire/sdk';

const result = new FunctionResult('Transferring now.')
  .connect('support@company.com', true, '+15559876543');
```

> Transfer or connect the call to another destination.