Skip to main content
POST
TypeScript

인증

Authorization
string
header
필수

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

developer:create_app

헤더

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
예시:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

본문

application/json
name
string
필수

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

예시:

"Shine Time Booking"

account_id
string

The account to create the app for (biz_ tag). Defaults to the account behind the presented credential.

예시:

"biz_xxxxxxxxxxxxxx"

app_type
enum<string>
기본값:b2c_app

The type of app to create. Defaults to b2c_app.

사용 가능한 옵션:
b2b_app,
b2c_app,
company_app,
component,
website
예시:

"website"

base_url
string | null

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

domain_id
string | null

A domain on the account (dom_ tag) to serve the app at, such as a whop.site address claimed with POST /domains. Required with template_id.

예시:

"dom_xxxxxxxxxxxxxx"

icon
object

The icon image for the app in PNG, JPEG, or GIF format, referencing an uploaded file: { id } for an existing attachment or { direct_upload_id } for a new direct upload.

imported_from_url
string | null

The address of the existing website this app is imported from, such as https://shop.example.com. Must be an http or https URL.

예시:

"https://shinetime.example"

redirect_uris
string[]

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

route
string | null
지원 중단

Deprecated: claim an address with POST /domains and pass domain_id. The subdomain route where the app's hosted web builds are served, such as myapp for myapp.whop.site.

예시:

"shine-time-booking-site"

응답

app created

account
object
필수

The account that owns the app.

api_key
object | null
필수

Legacy app API key used to authenticate requests on the app's behalf. null when no key exists or the caller lacks the developer:manage_api_key permission.

app_store_description
string | null
필수

Detailed description shown on the app store's in-depth app page, or null when none has been set.

예시:

"Shine Time Booking turns a whop into a booking calendar. Members pick a package, choose a slot that fits the day's route, and pay up front. A reminder goes out the night before and the receipt lands as soon as the job is signed off."

app_type
enum<string>
필수

The type of end-user the app is built for.

사용 가능한 옵션:
b2b_app,
b2c_app,
company_app,
component,
website
예시:

"b2c_app"

average_review_rating
number
필수

Average star rating across published reviews for this app, from 1.0 to 5.0. Returns 0.0 when no published-review rating is available.

예시:

0

banner_image
object | null
필수

Banner image from the app's product listing, or null when none is uploaded.

base_url
string | null
필수

The production base URL where the app is hosted. null if no base URL is configured, if the caller lacks the developer:basic:read permission on the app's account, or on list responses, which never expose it.

예시:

"https://shine-time-booking.whop.site"

businesses_created_count
integer
필수

Website businesses created from this app as a template.

예시:

5

businesses_created_logo_urls
string[]
필수

Up to three logo image URLs from businesses created from this app as a template.

businesses_with_recent_sales_count
integer
필수

Website businesses created from this app as a template that processed a payment in the last 24 hours. Recounted hourly, so it can be up to an hour behind.

예시:

0

category
object | null
필수

The app's App Store category, or null when none has been set. An app can show a category that GET /apps/categories does not list, if it was categorized before the current store categories.

creator
object
필수

The user who owns the publishing account.

dashboard_path
string | null
필수

URL path for the account dashboard view, or null when not configured.

예시:

"/dashboard/[companyId]"

default_api_key
object | null
필수

The app's default API key. null when the app has no default key or the caller lacks the developer:manage_api_key permission; secret_key is additionally null unless the caller could have created the key themselves.

deployment
object | null
필수

What the app has left to publish, and how a publish in flight is going — status is only ever unpublished, publishing, or failed here. null means there is nothing to report: the app is fully published, there is no working copy to publish from, or the caller cannot deploy this app. Tell those apart from the app's own production_web_build.

description
string | null
필수

Short description shown in listings and search results, or null if none has been set.

예시:

"Let members book a mobile detailing appointment without leaving your whop."

discover_path
string | null
필수

URL path for the discover view, or null when not configured.

예시:

"/discover"

domain_id
string
필수

Subdomain identifier for the app's proxied URL, forming https://{domain_id}.apps.whop.com.

예시:

"whopappdomain0000001"

domains
object[]
필수
elements_used
enum<string>[]
필수

Whop Elements the app's production web build mounts, as <namespace>.<element> keys (sub-controller children take a third segment, e.g. payments.cardFields.cardNumber). A bare namespace means the build reaches that namespace but the individual elements could not be resolved. Empty when the build mounts none, when it has not been scanned yet, or when the app has no production web build.

사용 가능한 옵션:
ads,
ads.billing-setup,
ads.campaign-creator,
ads.reporting,
ads.reporting.chart,
ads.reporting.table,
checkout,
checkout.checkout,
checkout.expressCheckout,
payments,
payments.address,
payments.branding,
payments.card,
payments.cardFields,
payments.cardFields.cardCvc,
payments.cardFields.cardExpiry,
payments.cardFields.cardNumber,
payments.email,
payments.payment,
payments.taxId,
tracking,
tracking.events,
tracking.people,
wallet,
wallet.activity,
wallet.balances,
wallet.balances.balance,
wallet.balances.list,
wallet.cards,
wallet.deposit,
wallet.send,
wallet.withdraw,
websites,
websites.pixel-setup,
websites.websites
experience_path
string | null
필수

URL path for the member-facing hub view, or null when not configured.

예시:

"/experiences/[experienceId]"

hosted_url
string | null
필수
지원 중단

Full URL where the app's hosted web build is served, or null if no route is claimed. DEPRECATED: Read domains instead.

예시:

"https://shine-time-booking.whop.site"

icon
object
필수

The app's icon. Falls back to the default app icon when none is uploaded.

id
string
필수

App ID, prefixed app_.

예시:

"app_xxxxxxxxxxxxxx"

imported_from_url
string | null
필수

The address of the existing website this app was imported from, such as https://shop.example.com. null if the app was not imported from another site, or if the caller lacks the developer:basic:read permission on the app's account.

예시:

"https://shinetime.example"

is_app_store_listed
boolean
필수

Whether the app is published, approved, and visible in the public app store.

예시:

false

is_whop_app
boolean
필수

Whether Whop publishes this app.

예시:

false

marketplace_status
enum<string> | null
필수

Approval status of the app's product listing on the Whop app store, or null when the app has no associated product.

사용 가능한 옵션:
not_available,
pending_review,
live_marketplace,
null
예시:

"not_available"

name
string
필수

Display name shown on the app store and in experience navigation.

예시:

"Shine Time Booking"

oauth_client_type
enum<string>
필수

How the app authenticates at the OAuth token endpoint.

사용 가능한 옵션:
public,
confidential
예시:

"public"

openapi_path
string | null
필수

URL path to the app's OpenAPI spec file, or null when not configured.

예시:

"/openapi.json"

origin
string | null
필수

Full origin URL of the app's proxied domain, for example https://ab1c2d3e4f.apps.whop.com.

예시:

"https://whopappdomain0000001.apps.whop.com"

per_install_schedule
string | null
필수

Five-field cron expression, read in UTC, on which Whop runs the production web build's scheduled() export once for every installation, with the installation in ctx.props.app_installation, no more often than every 15 minutes. Slots are skipped while the app has no production web build with a server entry. null when the app has no per-install schedule, or if the caller lacks the developer:basic:read permission on the app's account.

예시:

"*/15 * * * *"

preview_token
string | null
필수

A short-lived signed pass scoping the caller to this app's gated preview hosts — every build preview and the live dev-server sandbox. Add it to a preview host as the __whop_preview query param (or x-whop-preview-token header). null unless the caller is a team member who can read the app's developer settings.

예시:

"whop_preview_pass_example"

product_category
string | null
필수

Product category a business built from this app as a template sells, such as pressure_washing, or null when none has been set.

예시:

null

product_id
string | null
필수

ID of the app's product listing on the Whop app store, or null when the app has no associated product.

예시:

"prod_xxxxxxxxxxxxxx"

production_android_build
object | null
필수

The approved build currently served on Android, or null when none is deployed.

production_ios_build
object | null
필수

The approved build currently served on iOS, or null when none is deployed.

production_web_build
object | null
필수

The approved build currently served on web, or null when none is deployed.

published_reviews_count
integer
필수

Published customer reviews for this app.

예시:

0

redirect_uris
string[]
필수

Whitelisted OAuth callback URLs users are redirected to after authorizing the app.

requested_permissions
object[]
필수
required_scopes
enum<string>[]
필수

Scopes the app asks a user to grant when they authorize it, shown on the consent screen.

사용 가능한 옵션:
read_user
route
string | null
필수
지원 중단

Claimed subdomain route where hosted web builds are served (myapp for myapp.whop.site), or null if no route is claimed. DEPRECATED: Read domains instead.

예시:

"shine-time-booking"

schedule
string | null
필수

Five-field cron expression, read in UTC, on which Whop runs the production web build's scheduled() export once per slot. Slots are skipped while the app has no production web build with a server entry. null when the app has no global schedule, or if the caller lacks the developer:basic:read permission on the app's account.

예시:

"0 * * * *"

secrets
object | null
필수

The app's production secrets as an object of string values, injected into the hosted server runtime. null when the caller lacks the developer:update_app permission.

예시:
skills_path
string | null
필수

URL path to the app's skills directory, or null when not configured.

예시:

"/skills"

status
enum<string>
필수

Visibility on the Whop app store: live is publicly discoverable, unlisted is accessible only via direct link, hidden is not visible anywhere.

사용 가능한 옵션:
live,
unlisted,
hidden
예시:

"unlisted"

verified
boolean
필수

Whether the app has been verified by Whop and is eligible for the featured apps section.

예시:

false