Sign in
Apps

Create app

Register a new app on the Whop developer platform. Apps provide custom experiences that can be added to products.

Required permissions:

  • developer:create_app
  • developer:manage_api_key
  • developer:update_app
post/apps

Request body

base_urlstring nullable

The base production URL where the app is hosted, such as 'https://myapp.example.com'.

company_idstring required

The unique identifier of the company to create the app for, starting with 'biz_'.

namestring required

The display name for the app, shown to users on the app store and product pages.

redirect_urisstring[] nullable

The whitelisted OAuth callback URLs that users are redirected to after authorizing the app.

routestring nullable

The unique subdomain route where the app's hosted web builds are served, such as 'myapp' for myapp.whop.app.

Example request

{
  "company_id": "biz_xxxxxxxxxxxxxx"
}

Response

A successful response

app_type'b2b_app' | 'b2c_app' | 'company_app' | 'component' required

The type of end-user an app is built for

base_urlstring nullable required

The production base URL where the app is hosted. Null if no base URL is configured.

dashboard_pathstring nullable required

The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.

descriptionstring nullable required

A written description of what this app does, displayed on the app store listing page. Null if no description has been set.

discover_pathstring nullable required

The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.

domain_idstring required

The unique subdomain identifier for this app's proxied URL on the Whop platform. Forms the URL pattern https://{domain_id}.apps.whop.com.

experience_pathstring nullable required

The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.

hosted_urlstring nullable required

The full canonical URL where this app's hosted web build is served. Null if the app has not claimed a route.

idstring required

The unique identifier for the app.

namestring required

The display name of this app shown on the app store and in experience navigation. Maximum 30 characters.

openapi_pathstring nullable required

The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.

originstring nullable required

The full origin URL for this app's proxied domain (e.g., 'https://myapp.apps.whop.com'). Null if no proxy domain is configured.

redirect_urisstring[] required

The whitelisted OAuth callback URLs that users are redirected to after authorizing the app.

routestring nullable required

The unique subdomain route where this app's hosted web builds are served, such as 'myapp' for myapp.whop.app. Null if the app has not claimed a route.

secretsobject nullable required

The app's secrets as an object of string values. Encrypted at rest and injected into the app's hosted server runtime as environment bindings. Requires the 'developer:update_app' permission.

skills_pathstring nullable required

The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.

status'live' | 'unlisted' | 'hidden' required

The status of an experience interface

verifiedboolean required

Whether this app has been verified by Whop. Verified apps are endorsed by Whop and displayed in the featured apps section of the app store.

Example response

{
  "api_key": {
    "created_at": "2023-12-01T05:00:00.401Z"
  },
  "base_url": "https://myapp.example.com",
  "company": {
    "id": "biz_xxxxxxxxxxxxxx",
    "title": "Pickaxe"
  },
  "creator": {
    "id": "user_xxxxxxxxxxxxx",
    "name": "John Doe",
    "username": "johndoe42"
  },
  "dashboard_path": "/experiences/[experienceId]",
  "description": "A comprehensive analytics dashboard for tracking revenue, members, and growth metrics.",
  "discover_path": "/experiences/[experienceId]",
  "domain_id": "ab1c2d3e4f5g6h7i8j9k",
  "experience_path": "/experiences/[experienceId]",
  "hosted_url": "https://myapp.whop.app",
  "icon": {
    "url": "https://media.whop.com/abc123/optimized.jpg"
  },
  "id": "app_xxxxxxxxxxxxxx",
  "name": "Courses",
  "openapi_path": "/experiences/[experienceId]",
  "production_web_build": {
    "checksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "file_url": "https://cdn.whop.com/builds/abc123.zip",
    "id": "apbu_xxxxxxxxxxxxx"
  },
  "route": "myapp",
  "skills_path": "/experiences/[experienceId]",
  "stats": {
    "dau": 42,
    "mau": 42,
    "time_spent_last24_hours": 42,
    "wau": 42
  }
}

Changes