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

# `createChannel`

Create a Farcaster Auth relay channel.

Returns a secret token identifying the channel, and a URI to display to the end user as a link or QR code.

```ts theme={"system"}
const channel = await appClient.createChannel({
  siweUri: 'https://example.com/login',
  domain: 'example.com',
});
```

## Parameters

| Parameter           | Type      | Description                                                                                                                   | Required | Example                                |
| ------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------- | -------- | -------------------------------------- |
| `siweUri`           | `string`  | Login URL for your application.                                                                                               | Yes      | `https://example.com/login`            |
| `domain`            | `string`  | Domain of your application.                                                                                                   | Yes      | `example.com`                          |
| `nonce`             | `string`  | A custom nonce. Must be at least 8 alphanumeric characters.                                                                   | No       | `ESsxs6MaFio7OvqWb`                    |
| `notBefore`         | `string`  | Start time at which the signature becomes valid. ISO 8601 datetime.                                                           | No       | `2023-12-20T23:21:24.917Z`             |
| `expirationTime`    | `string`  | Expiration time at which the signature is no longer valid. ISO 8601 datetime.                                                 | No       | `2023-12-20T23:21:24.917Z`             |
| `requestId`         | `string`  | A system specific ID your app can use to refer to the sign in request.                                                        | No       | `8d0494d9-e0cf-402b-ab0a-394ac7fe07a0` |
| `acceptAuthAddress` | `boolean` | Whether your application accepts signatures from an [auth address](https://github.com/farcasterxyz/protocol/discussions/225). | No       | `true`                                 |

## Returns

```ts theme={"system"}
{
  response: Response;
  data: {
    channelToken: string;
    url: string;
    nonce: string;
  }
  isError: boolean;
  error: Error;
}
```

| Parameter           | Description                                                                             |
| ------------------- | --------------------------------------------------------------------------------------- |
| `response`          | HTTP response from the Connect relay server.                                            |
| `data.channelToken` | Connect relay channel token.                                                            |
| `data.url`          | Sign in With Farcaster URL to present to the user. Links to the Farcaster client in v1. |
| `data.nonce`        | Random nonce included in the Sign in With Farcaster message.                            |
| `isError`           | True when an error has occurred.                                                        |
| `error`             | `Error` instance.                                                                       |