API: Create New Apps

This API lets you manually create a new app. If you want to upload an app instead, please check out this document.

Request

  • URL: https://rink.hockeyapp.net/api/2/apps/new
  • HTTP Method: POST
  • Authentification: set the HTTP header X-HockeyAppToken to your API token (create one here)
  • Parameters:
    • title - required, the app's name
    • bundle_identifier - required, the bundle identifier on iOS or Mac OS X, the package name on Android, or the namespace on Windows Phone
    • platform - optional, the app's platform:
      • iOS [default]
      • Android
      • Mac OS
      • Windows Phone
      • Custom
    • release_type - optional, set the release type of the app:
      • 2: Alpha
      • 0: Beta [default]
      • 1: Live

Example:

curl \
  -F "title=My App" \
  -F "bundle_identifier=de.codenauts.myapp" \
  -F "platform=iOS" \
  -F "release_type=1" \
  -H "X-HockeyAppToken: 4567abcd8901ef234567abcd8901ef23" \
  https://rink.hockeyapp.net/api/2/apps/new

Responses

Successful

Status: 201
Body:

{
    "title": "HockeyTest",
    "bundle_identifier": "de.codenauts.hockeytest",
    "public_identifier": "1234567890abcdef1234567890abcdef",
    "release_type": 0,
    "platform": "iOS"
}

Error: Maximum number of apps reached

Status: 422
Body:

{
    "errors": {
        "ipa": [
            "maximum number of apps reached"
        ]
    }
}

Error: Token not authorized to create a new app

Status: 422
Body:

{
    "errors": {
        "ipa": [
            "not authorized to create a new app"
        ]
    }
}

Authentification failed

Status: 401
Body:

{
    "errors": {
        "credentials": [
            "user not found or token invalid"
        ]
    }
}