App Builds

Create App Build

Changed on

Uploads a new build artifact for an app. Upload the file first with POST /files or a direct upload, then reference it in attachment.

post/app_builds

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/app_builds
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

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

Request body

app_idstring

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

checksumstring required

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

platform'ios' | 'android' | 'web' required

The target platform for the build.

supported_app_view_typesstring[]

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

Example request

{
  "app_id": "app_xxxxxxxxxxxxxx",
  "attachment": {
    "direct_upload_id": "eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "id": "file_xxxxxxxxxxxxxx"
  },
  "checksum": "xxxxxxxxxxxxxxx",
  "platform": "web",
  "source_attachment": {
    "direct_upload_id": "eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "id": "file_xxxxxxxxxxxxxx"
  },
  "supported_app_view_types": [
    "hub"
  ]
}

Response

app build created

checksumstring required

Client-generated checksum of the build file, used to verify file integrity.

created_atstring required

When the build was uploaded, as an ISO 8601 timestamp.

file_urlstring nullable required

URL to download the uploaded build artifact.

idstring required

App build ID, prefixed abld_.

is_productionboolean required

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

platform'ios' | 'android' | 'web' required

The target platform for this build.

review_messagestring nullable required

Feedback from the reviewer explaining a rejection, or null if the build has not been reviewed or was approved.

source_urlstring nullable required

URL to download the compressed source code archive that produced this build, or null when the build was uploaded without a source archive.

status'draft' | 'pending' | 'approved' | 'rejected' required

The build's review status.

supported_app_view_typesstring[] required

Example response

{
  "checksum": "xxxxxxxxxxxxxxx",
  "created_at": "2026-01-01T12:00:00.000Z",
  "file_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "id": "apbu_xxxxxxxxxxxxxx",
  "platform": "ios",
  "review_message": "The hub view crashes on launch when the member has no active membership. Fix and resubmit.",
  "source_url": "https://whop-assets-example.s3.amazonaws.com/uploads/zip/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "rejected",
  "supported_app_view_types": [
    "hub"
  ]
}

Changes

  • d94adec84933Revision changes
    • info

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

  • 54dbb42f6781Revision changes
    • info

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth