Skip to main content

Overview

To authenticate with ntfy, you need:
  1. Server Host — the host of your ntfy server: ntfy.sh or your self-hosted domain.
  2. Access Token — a token that starts with tk_.
This guide will show you how to find both.

Prerequisites

  • A user account on ntfy.sh or on your self-hosted ntfy server.

Step 1: Find your ntfy server host

  • On the public server, your host is ntfy.sh.
  • On a self-hosted server, copy the host from the address bar of your ntfy web app, without https:// or any path, for example ntfy.example.com.

Step 2: Create an access token

  1. Sign in to the ntfy web app (for example ntfy.sh/app) and click Account in the left sidebar.
ntfy web app with Account in the left sidebar
  1. Scroll to Access tokens and click Create access token.
ntfy Account page with the Create access token button in the Access tokens section
  1. Enter a label, choose an expiry, and click Create token.
ntfy Create access token dialog with a label, an expiry and the Create token button
  1. In the Access tokens table, click the copy icon next to the new token to copy it.
ntfy Access tokens table with the copy icon next to the new token On a self-hosted server, you can also create a token with the ntfy CLI, for example ntfy token add --expires=30d --label="nango" <username>. See Access tokens for details.

Step 3: Enter your server host and access token in the Connect UI

  1. Open the form where you need to authenticate with ntfy.
  2. Enter your Server Host and your token in the Access Token field.
  3. Submit the form, and you should be successfully authenticated.
ntfy Connect UI form with the Server Host and Access Token fields You are now connected to ntfy.