Get familiar with the Applivery API and explore the features

Upload a Build

The Upload Build request endpoint is intended to upload a new Build (.ipa or .apk or .aab binary files) to Applivery.


  • Authentication: required
  • Headers:
    • Authorization: bearer <Your_App_Token>

Param Type Description
build File .ipa or .apk or .aab binary file
versionName String Human readable version name for this build. E.g.: RC-1
tags Array Comma separated tags. E.g.: tag1, tag2, tag3
changelog String Build release notes or log of changes E.g.: Bug fixing!.
notifyCollaborators Boolean Notify App and Organization collaborators. E.g.: true
notifyEmployees Boolean Notify App and Organization employees. E.g.: true
filter Nested array of strings List of groups that will be notified with support for AND / OR clauses. Each element within the same array will be considered as AND while each array will be an OR clause. E.g.: To notify users in group1 AND group2 OR in group3 use: [["group1", "group2"],["group3"]]
notifyMessage String Notification message to send in the email. E.g.: Enjoy the App! String Custom deployer display name. E.g.: Jenkins CI String Git commit message. E.g.: Fixed issue #123 String Git commit. E.g.: f52ace0 String Git branch. E.g.: develop String Git tag. E.g.: RC-1 String CI trigger date/time. E.g.: 1558359012580 String CI build URL. E.g.: https://... String CI platform URL. E.g.: https://... String Version control repository URL. E.g.: https://... String CI platform build number. E.g.: 73

CURL Request Example

curl '' \
  -X POST \
  -H 'Authorization: bearer' \
  -F build=@'file.ipa' \
  -F 'versionName=My awesome app version' \
  -F 'tags=tag1, tag2, tag3' \
  -F 'changelog=Bug fixing' \
  -F notifyCollaborators=false \
  -F notifyEmployees=false \
  -F 'notifyMessage=Enjoy the App' \
  -F 'filter[0][]=group1' \
  -F 'filter[0][]=group2' \
  -F 'filter[1][]=group3' \
  -F ' CI PLatform' \
  -F ' issue 123' \
  -F '' \
  -F '' \
  -F '' \
  -F '' \
  -F '' \
  -F '' \
  -F '' \
  -F ''


    "status": false,
    "error": {
        "code": 5006,
        "message": "No File Found in request"
  "status": true,
  "error": {
    "code": 2001,
    "message": "Token not valid"
  "status": true,
  "error": {
    "code": 4001,
    "message": "Entity not found"