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

# Onboarding links

> You need only one link to connect WhatsApp or Instagram.

They click through Meta official connect flow, and the channel appears in your dashboard.

## Create link

In the app: open the customer menu and choose **New Link**.
From the terminal:

```bash theme={null}
# WhatsApp
hookmyapp customers onboarding-links create --label "Acme" --channel-type whatsapp

# Instagram
hookmyapp customers onboarding-links create --label "Acme Instagram" --channel-type instagram
```

Two ways to target it:

* **Tied to a customer:** add `--customer ws_XXXXXXXX` and the connected channel lands in that existing customer.
* **Open:** leave it untargeted and a new customer is created the moment someone connects through it.

`--channel-type` accepts `whatsapp` or `instagram`.

Set `successRedirectUrl`, `failureRedirectUrl`, and `connectedNotificationUrl` when you create a link to know the moment a customer's connect succeeds or fails. See [Connection events](/saas-mode/connection-events).

## Links stay available

Links are not one-time secrets.
Every link you created stays listed, reopenable, and copyable, so you can resend it whenever a customer loses the email:

```bash theme={null}
hookmyapp customers onboarding-links list
```

## Message destination

Set your organization default destination webhook once (in the app under your organization webhook settings), and every channel connected through an onboarding link forwards there automatically.
Admins can also apply the destination to existing channels in bulk.
Any channel can be repointed individually later.

See [API overview](/saas-mode/api/overview) or [CLI](/saas-mode/cli) for customer-channel webhook commands.
