API-first
Every feature available through a comprehensive REST API. Automate everything.
Full REST API
Every feature in the admin console is available programmatically. No exceptions.
Official SDKs
Type-safe client libraries for TypeScript, Python, Go, and more. Get started in minutes.
Webhooks
Real-time event notifications for user lifecycle, authentication events, and configuration changes.
0
Every feature is accessible via API
OpenAPI 3.1 spec
Complete machine-readable spec
Real-time webhooks
Sub-second event delivery
noo id is built API-first, meaning the REST API is the primary interface and the admin console is just another client. Official SDKs for six languages give you type-safe access to every endpoint, and real-time webhooks keep your systems in sync without polling.
Complete REST API
Every feature in the admin console is available programmatically through a well-designed REST API. Use the official TypeScript SDK to manage users, sessions, groups, and authentication policies with full type safety.
import { NooClient } from '@noo-id/sdk';
const client = new NooClient({
apiKey: process.env.NOO_API_KEY,
});
const user = await client.users.create({
email: 'alice@acme.com',
name: 'Alice Smith',
});
Official SDKs
TypeScript
Fully typed client with native TypeScript definitions. Install with npm install @noo-id/sdk.
Python
Type-hinted SDK compatible with mypy for static analysis. Install with pip install noo-id.
Go
Strongly typed structs and idiomatic error handling. Install with go get github.com/noo-id/noo-go.
Ruby
Idiomatic Ruby client with built-in retries. Install with gem install noo_id.
PHP
PSR-compatible SDK with full type coverage. Install with composer require noo-id/sdk.
Java
Generics-based client with async support. Available via Maven as com.noo.id:noo-sdk.
Webhook event flow
Receive real-time HTTP notifications whenever events occur in noo id. Subscribe to user lifecycle events, authentication events, and configuration changes with automatic retries and delivery guarantees.
Event occurs
A user signs up, logs in, updates their profile, or any other trackable action happens in noo id.
noo id sends POST
An HTTP POST request with a signed JSON payload is dispatched to your configured webhook endpoint.
Your app verifies signature
Validate the X-Noo-Signature header using HMAC SHA-256 to confirm the request is authentic.
Process event async
Return a 200 response immediately and handle the event payload asynchronously via a background queue.
Developer experience
OpenAPI 3.1 spec
A complete machine-readable specification you can use to generate clients, import into Postman, or validate requests.
Interactive docs
Try API calls directly from the browser with example requests, responses, and copy-ready code snippets.
Structured errors
Every error returns a consistent JSON body with an error code, human-readable message, and a link to documentation.
Rate limiting
Transparent rate limits with X-RateLimit headers on every response so you can throttle proactively.
Frequently asked questions
What does API-first mean? +
API-first means the API is not an afterthought - it's the primary interface for noo id. Every feature is built as an API first, and the admin console is just another client of that API. This ensures complete programmatic access to all functionality, enabling full automation and custom integrations.
Which programming languages have official SDKs? +
noo id provides official SDKs for TypeScript/JavaScript, Python, Go, Ruby, PHP, Java, and .NET. All SDKs are open source, automatically generated from the OpenAPI specification, and include full TypeScript types or equivalent type safety for other languages. Community-maintained SDKs are available for additional languages.
How do webhooks work and what events can I subscribe to? +
Webhooks deliver real-time HTTP POST requests to your endpoint when events occur. You can subscribe to user events (created, updated, deleted), authentication events (login, logout, MFA), admin actions (configuration changes), and more. Webhooks include retry logic, signature verification, and delivery guarantees.