Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Headers

Idempotency-Key
string

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

Maximum string length: 255
Example:

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

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-07-20"

Body

application/json
attachment
object
required

The uploaded build file: { id } for an existing file or { direct_upload_id } for a completed direct upload.

checksum
string
required

A client-generated checksum of the build file, used to verify file integrity when unpacked.

platform
enum<string>
required

The target platform for the build.

Available options:
ios,
android,
web
ai_prompt_id
string

The AI prompt that generated this build, if applicable.

app_id
string

The app to create the build for, prefixed app_. Defaults to the app behind the presented credential.

source_attachment
object

An optional compressed archive (.zip or .gz) of the source code that produced this build, stored alongside the build so it can be downloaded later. Referenced like attachment, and must be a different file.

supported_app_view_types
enum<string>[]

The view types this build supports. Only list the ones its code implements.

Available options:
hub,
discover,
dash,
dashboard,
analytics,
skills,
openapi

Response

app build created

A versioned build artifact for a Whop React Native App, submitted for review and deployment to a specific platform.

checksum
string
required

A SHA-256 hash of the uploaded build file, generated by the client and used to verify file integrity.

Example:

"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

created_at
string<date-time>
required

The datetime the app build was created.

Example:

"2023-12-01T05:00:00.401Z"

file_url
string
required

A URL to download the app build as a .zip archive.

Example:

"https://cdn.whop.com/builds/abc123.zip"

id
string
required

The unique identifier for the app build.

Example:

"apbu_xxxxxxxxxxxxx"

is_production
boolean
required

Whether this build is the currently active production build for its platform.

platform
enum<string>
required

The target platform for this build.

Available options:
ios,
android,
web
review_message
string | null
required

Feedback from the reviewer explaining why the build was rejected. Null if the build has not been reviewed or was approved.

Example:

"App crashes on launch. Please fix and resubmit."

source_url
string | null
required

A URL to download the compressed source code archive that produced this build. Null if the build was uploaded without a source archive.

Example:

"https://cdn.whop.com/builds/abc123-source.zip"

status
enum<string>
required

The current review status of this build.

Available options:
draft,
pending,
approved,
rejected
supported_app_view_types
enum<string>[]
required

The list of view types this build supports, as declared by the developer.

The different types of an app view

Available options:
hub,
discover,
dash,
dashboard,
analytics,
skills,
openapi