Getting Started

Introduction

Learn how to integrate Interna into your application and start building with our platform APIs.

Overview

Interna provides a unified platform for managing identity, access control, and organizational data. Our APIs are designed for developers who need reliable, well-documented interfaces to build secure applications.

Whether you're building a SaaS product, internal tooling, or a customer-facing portal, Interna gives you the building blocks to handle authentication, authorization, and user management without reinventing the wheel.

Key Features

  • Multi-tenant architecture — Built-in support for organizations, teams, and role-based access control.
  • RESTful APIs — Clean, predictable endpoints following REST conventions with comprehensive error handling.
  • SDKs for major languages — Official client libraries for Node.js, Python, Go, and Ruby.
  • Webhooks — Real-time event notifications for user lifecycle, permission changes, and more.
  • Enterprise SSO — SAML 2.0 and OIDC integration for enterprise customers out of the box.

Architecture

Interna follows a microservices architecture with a unified API gateway. All requests are authenticated at the gateway level before being routed to the appropriate service.

Supported Environments

EnvironmentBase URLPurpose
Productionapi.interna.devLive production workloads
Stagingstaging-api.interna.devPre-production testing
Sandboxsandbox-api.interna.devDevelopment and experimentation

Quick Example

Here's a minimal example showing how to initialize the client and fetch the current user:

example.ts
import { Interna } from "@interna/sdk";

const client = new Interna({
  apiKey: process.env.INTERNA_API_KEY,
  environment: "production",
});

const user = await client.users.getCurrent();
console.log(user.email, user.organization.name);

Next Steps