Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.entri.com/llms.txt

Use this file to discover all available pages before exploring further.

Welcome to Entri! This guide will walk you through your first integration.
New to DNS? Check out DNS Concepts for a quick primer on record types, propagation, and common gotchas.

​
1. Set up your dashboard

Before writing code, configure your application in the Entri Dashboard:
  1. Sign up or log in
  2. Create an application
  3. Set your display name and icon (PNG or SVG, 1:1 ratio, white or transparent background)
  4. Copy your applicationId and secret
Dashboard

​
2. Install Entri

Choose your preferred installation method: 
<script src="https://cdn.goentri.com/entri.js"></script>
If using npm, import it in your code: 
import Entri from 'entrijs';
Subresource Integrity (SRI): If your security policy requires SRI, load Entri via the pinned loader URL with its SHA-384 hash:
<script
  src="https://cdn.goentri.com/entri-latest.js"
  integrity="sha384-wnpzG3Yw9ogy4KIE2XZ/Cn9/fqwjb53eR5Te9a3cjud6UZF5wbmQrfWFKfBwZfaI"
  crossorigin="anonymous"></script>
The loader at entri-latest.js is immutable, so the integrity hash above stays valid across Entri SDK releases — no need to update it on each version.Because the loader fetches the SDK asynchronously, window.entri isn’t available immediately. Wait for the entri:ready event before calling showEntri():
function onEntriReady(cb) {
  if (window.entri) return cb(window.entri);
  window.addEventListener("entri:ready", () => cb(window.entri), { once: true });
}

onEntriReady((entri) => {
  entri.showEntri(/* …config… */);
});

​
3. Get a JWT token

For security, fetch the JWT on your server-side. The token expires after 60 minutes.
Never expose your secret in client-side code. Always fetch the JWT from your backend.
fetch('https://api.goentri.com/token', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    applicationId: "YOUR_APP_ID",    // From the dashboard
    secret: "YOUR_SECRET"            // From the dashboard
  }),
})
.then(response => response.json())
.then(data => {
  console.log('Token:', data.auth_token);
  // Save this token to use in step 4
})
.catch(error => console.error('Error:', error));

​
4. Launch the Entri modal

With your token ready, launch the Entri modal: 
entri.showEntri({
  applicationId: "YOUR_APP_ID",
  token: "YOUR_JWT_TOKEN",  // From step 3
  dnsRecords: [
    {
      type: "CNAME",
      host: "www",
      value: "your-app.com",
      ttl: 300
    }
  ]
});
MX records require a priority field. See DNS Records for all record types.

​
5. Handle events

Listen for completion and close events: 
entri.showEntri({
  applicationId: "YOUR_APP_ID",
  token: "YOUR_JWT_TOKEN",
  dnsRecords: [...],

  // Called when DNS setup completes successfully
  onSuccess: (data) => {
    console.log('Domain configured:', data.domain);
    // { domain: "example.com", success: true, setupType: "automatic", ... }
  },

  // Called when the modal is closed
  onEntriClose: (data) => {
    console.log('Modal closed:', data);
  }
});

​
Complete example: React

Here’s a full working example with React: 
import { useEffect, useState } from 'react';

function DomainSetup() {
  const [token, setToken] = useState(null);

  useEffect(() => {
    // Fetch JWT from your backend
    fetch('/api/entri-token')
      .then(res => res.json())
      .then(data => setToken(data.token));
  }, []);

  const handleSetup = () => {
    if (!token) return;

    entri.showEntri({
      applicationId: "YOUR_APP_ID",
      token: token,
      dnsRecords: [
        {
          type: "CNAME",
          host: "www",
          value: "your-app.com",
          ttl: 300
        }
      ],
      onSuccess: (data) => {
        console.log('Success:', data);
        // Update your UI or backend
      }
    });
  };

  return (
    <button onClick={handleSetup} disabled={!token}>
      Connect Your Domain
    </button>
  );
}

export default DomainSetup;
For more framework-specific examples, see our React Integration Guide and Vanilla JS Guide.

​
Next steps

Now that you have the basics working, explore Entri’s products:

Connect

Automated DNS configuration for 60+ providers

Sell

Let users purchase domains in your app

Secure

Automatic SSL certificate provisioning

Power

Custom domain management for your users

​
Dive deeper

Configuration Reference

All showEntri() options

Events Reference

Complete events documentation

Webhooks

Server-side notifications

DNS Concepts

Understanding DNS records

​
Need help?

We’re here to help! Email us at support@entri.com or reach out to your account manager.