Skip to main content
Bondify lets your users sign in with a single tap in Telegram — no passwords to remember, no SMS codes to type. Install the SDK, drop in a button, and your app has secure messenger-based authentication in under 5 minutes.

Quickstart

Integrate Telegram auth into your app in under 5 minutes

How It Works

Understand the session lifecycle and authentication flow

API Reference

Explore REST endpoints, request schemas, and response formats

SDK Reference

Drop-in JavaScript, React, and Node.js SDK documentation

Get up and running

1

Create a free account

Sign up at bondify.dev and create your first project to get a project ID and secret key.
2

Install the SDK

Add Bondify to your project with one command:
npm install @bondify/sdk
3

Add the auth button

Drop <PulseButton> into your login page (React) or use the HTML widget for any framework:
import { PulseProvider, PulseButton } from '@bondify/sdk';

export default function LoginPage() {
  return (
    <PulseProvider projectId="proj_xxxxxxxx">
      <PulseButton onSuccess={(user) => console.log(user)} />
    </PulseProvider>
  );
}
4

Verify the proof server-side

After a successful login, verify the cryptographic proof on your server before creating a session:
import { verifyProof } from '@bondify/server';

const user = await verifyProof(proof, process.env.BONDIFY_SECRET);
// user.telegramId, user.name, user.username

Choose your integration

HTML Widget

One <script> tag, works in any framework

React

Drop-in components and hooks

Next.js

Server Actions and App Router support

Node.js

Express, Fastify, or any Node backend

Flutter

Native mobile auth for iOS and Android

REST API

Direct HTTP integration for any stack

Why Bondify?

No passwords or SMS

Users authenticate via Telegram — no new credentials to create or forget

Cryptographic proof

Every session returns an HMAC-SHA256 signed JWT verifiable on your server

Real-time webhooks

Receive auth.confirmed and auth.cancelled events instantly

Analytics dashboard

Track conversion rates, daily active users, and session funnels