How to add a key to Happ

Before you start: what a key looks like

A Happ key comes in one of two shapes.

A subscription link looks like https://provider-domain/sub/long-identifier. The app fetches it and receives the current list of servers. When the provider changes servers, your list updates on its own. The identifier is the secret part: whoever has the link can connect.

A single config is one line starting with vless://, vmess:// or trojan://. It describes exactly one server and stops working when that server goes away.

Do not paste the address of your provider’s dashboard page. That is a web page, not a subscription, and Happ will answer with “Unknown content type”.

Method 1: from the clipboard

This is the most reliable way on every platform.

1. In your provider’s dashboard or bot, press the copy button next to the link.
2. Open Happ and tap + in the top-right corner.
3. Choose the clipboard import.
4. Wait a few seconds for the servers to appear.

If Happ says the clipboard is empty, the copy never registered. Some phones clear the clipboard when you switch apps, so go straight from copying to Happ. The full explanation is on the “Clipboard is empty” page.

Method 2: by QR code

Useful when the link is open on a computer and you need it on your phone, or when the clipboard keeps failing.

1. Show the subscription QR code in your provider’s dashboard.
2. In Happ, tap + and choose to scan a QR code.
3. Point the camera at the screen.

Scanning skips the clipboard entirely, so it also works around clipboard errors.

Method 3: by deeplink

Some providers give a link that starts with happ://. Tapping it opens Happ and hands over the subscription in one step. Encrypted links start with happ://crypt. Open them only from a source you trust: you cannot see what is inside before importing.

Method 4: a single vless:// line

1. Copy the whole line, from vless:// to the very end.
2. In Happ, tap + and import from the clipboard.
3. Check that no space or line break slipped in — chat apps like to wrap long lines.

A single line works until that one server stops responding. If your provider offers a subscription link, use that instead.

How to tell it worked

A list of servers appears, usually several entries named after countries. Pick one and connect. When the tunnel is up, a VPN icon shows in the status bar.

If the list is empty, the app got nothing usable back. Copy the link again and retry on a different network. If Happ waits and then reports a timeout, the provider’s server did not answer in time — see “Timeout while adding a subscription”.

When Happ rejects the key

In order of likelihood:

1. Copied incompletely. Copy again with the button, not by selecting.
2. A space or a line break inside. Usually added by a messenger on the way.
3. The subscription has expired or been revoked. Check its status where you got it. Public keys die fastest: here is why.
4. The provider’s server is down. Try again in a few minutes.

Each error message Happ shows points at a different stage. The list of Happ error messages explains what every one of them means.

Where to get a key

Happ itself does not sell or hand out servers. A key comes from a public source, a free trial or a paid subscription from a separate service. A free trial is the quickest way to check that everything above works on your own device before paying for anything.