Getting started
Introduction
The Okta Partners platform lets you build apps that integrate with Okta — reading and writing tenant data within explicitly granted scopes — and publish them to the app store for any tenant to install.
Overview
Okta is a multi-tenant education platform. As a partner you build an app that requests a set of scopes, gets reviewed by the Okta team, then ships. When a tenant installs your app and grants the scopes, your app receives an installation token it uses to call the runtime API hosted by okta-web.
These docs are fully public — share them with any AI tool. Every page is available as raw Markdown and indexed via llms.txt.
Who it is for
- SaaS companies wanting to offer their services to Okta schools and universities.
- Developers building custom integrations on top of tenant data (students, employees, classes…).
- Notification-channel providers (WhatsApp / SMS / Push) plugging into the platform.
Integration types
You pick an integration type when creating the app — a pivotal choice that shapes the rest of the journey:
| Type | Hosting | Communication |
|---|---|---|
| Embedded | Inside Okta (as code) | In-process via Partner API services |
| External | At the partner | REST API + signed Webhooks |
| Notification | Partner / Okta / hybrid | A unified send() interface per recipient |
How it works
- Register a partner account, create your app, and pick the scopes you need.
- Submit for review — the Okta team validates the manifest and (for Embedded) runs the policy scanner.
- Your app ships to the store; tenants install it and grant the scopes.
- Your app calls the runtime API with its installation token, within the granted scopes.
Next steps
Developer guide
The full journey: manifest, sandbox, publishing, policy scanner.
API reference
Endpoints, scopes, pagination, errors, and webhook signing.
Authentication
How your app obtains and uses its installation token.
Apply as a partner
Start by creating a partner account and launching your first app.