Upload a Build

Upload a Build

You are viewing the Apps API whose scope is limited to Apps. If you are looking for the full API spec, check the Organizations API.

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


  • Method: POST
  • URL: https://api.applivery.io/v1/integrations/builds
  • 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!.
notifyLanguage String "es" "en" "fr" "ge" "it" "zh" "pt" "ru"
deployer.name String Custom deployer display name. E.g.: Jenkins CI
deployer.info.commitMessage String Git commit message. E.g.: Fixed issue #123
deployer.info.commit String Git commit. E.g.: f52ace0
deployer.info.branch String Git branch. E.g.:develop
deployer.info.tag String Git tag. E.g.: RC-1
deployer.info.triggerTimestamp String CI trigger date/time. E.g.: 1558359012580
deployer.info.buildUrl String CI build URL. E.g.: https://...
deployer.info.ciUrl String CI platform URL. E.g.: https://...
deployer.info.repositoryUrl String Version control repository URL. E.g.: https://...
deployer.info.buildNumber String CI platform build number. E.g.: 73

Example request

curl 'https://api.applivery.io/v1/integrations/builds' \
  -X POST \
  -H 'Authorization: bearer xyz...xyz' \
  -F [email protected]'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 'notifyLanguage=en' \
  -F 'filter[0][]=group1' \
  -F 'filter[0][]=group2' \
  -F 'filter[1][]=group3' \
  -F 'deployer.name=Custom CI PLatform' \
  -F 'deployer.info.commitMessage=Fixed issue 123' \
  -F 'deployer.info.commit=f52ace0' \
  -F 'deployer.info.branch=develop' \
  -F 'deployer.info.tag=RC-1' \
  -F 'deployer.info.triggerTimestamp=1558359012580' \
  -F 'deployer.info.buildUrl=http://www.applivery.io/build/73' \
  -F 'deployer.info.ciUrl=http://www.applivery.io/ci' \
  -F 'deployer.info.repositoryUrl=https://github.com/applivery/applivery-ios-sdk' \
  -F 'deployer.info.buildNumber=173'


Content type: application/json

Do you want to know more?

API Overview

Know more about the Applivery API's and resources and check the entire API Reference.

API Reference introduction
POSTMAN Collection

Download the sample POSTMAN collection and speed up your integration.

POSTMAN Collection

Doc Content