Step 2: Create Your App
An App in 23blocks is a container for your project. It holds your blocks, API keys, and configuration. You can create multiple apps for different projects or environments.
Create a New App
-
From your Dashboard, click "Create App"
-
Fill in the app details:
| Field | Description | Example |
|---|---|---|
| App Name | A friendly name for your project | "My eLearning Platform" |
| App Slug | URL-friendly identifier (auto-generated) | "my-elearning-platform" |
| Description | Optional notes about this app | "Main learning platform v1" |
- Click "Create"
Your app is now created! You'll be taken to the app overview page.
App Overview
Every app has its own dedicated page showing:
| Tab | What's There |
|---|---|
| Overview | App status, quick stats, getting started tips |
| Blocks | Add and configure backend blocks |
| API Keys | Your app's credentials |
| Settings | App configuration, danger zone |
| Logs | API call logs and debugging |
Your App Credentials
When you create an app, you automatically get:
| Credential | Purpose |
|---|---|
| App ID | Unique identifier for your app |
| API Key | Secret key for authenticating requests |
| Base URL | Your app's API endpoint |
Never expose your API key in client-side code, public repositories, or browser console. Use environment variables and server-side calls for sensitive operations.
Finding Your Credentials
- Go to your app's API Keys tab
- Copy the credentials you need:
API Key: pk_live_xxxxxxxx or sk_live_xxxxxxxx
Service URLs: Each block has its own URL:
Auth: https://auth.api.us.23blocks.com
Files: https://files.api.us.23blocks.com
Content: https://content.api.us.23blocks.com
...and more
Live Keys Only: The Shared Platform is production-only - all API keys are live keys (pk_live_* / sk_live_*). A staging environment is available as a paid add-on on own-account deployments (Dedicated Cloud, Self-Managed, Partner Managed).
Multiple Apps
Most teams create multiple apps for different purposes:
| App | Purpose |
|---|---|
| my-app-dev | Local development and testing |
| my-app-production | Live production environment on the Shared Platform |
The Shared Platform is production-only. If you need a staging environment, it's available as a paid add-on on own-account deployments (Dedicated Cloud, Self-Managed, or Partner Managed).
Each app has its own:
- Isolated database
- Separate API keys
- Independent block configuration
- Usage limits and billing
What's Next?
Your app is created. Now let's add the backend blocks you need.
Quick Reference
| Action | Where |
|---|---|
| Edit app name | App → Settings |
| Rotate API key | App → API Keys → Rotate |
| Delete app | App → Settings → Danger Zone |
| View logs | App → Logs |