Java SDK for use with the Bandwidth Voice and Messaging APIs
Clone or download

Bandwidth Java SDK API

Java SDK for Bandwidth's App Platform


[More Coming Soon]


Code Examples


Bandwidth Java SDK API is now using Maven. At present the jars are available from a public maven repository.

Use the following dependency in your project:


If you want to compile it yourself, here's how:

$ git clone
$ cd java-bandwidth.git
$ mvn install

Set credentials

There are 3 ways to set these credentials:

  1. Via Java VM System Properties, set as -D arguments on the VM command line:
  2. Via environment variables:
    $ export BANDWIDTH_USER_ID=my_User_Id
    $ export BANDWIDTH_API_TOKEN=my_Api_Token
    $ export BANDWIDTH_API_SECRET=my_Api_Secret
  3. Directly by way of a method call on the BandwidthClient object
    BandwidthClient.getInstance().setCredentials(my_User_Id, my_Api_Token, my_Api_Secret)

Notice: if credentials are not set explicitly, the sdk will first look for VM properties. If those are not present, it will look for environments vars. To override VM properties and env vars, use client's method as described on 3th option.


Please open an issue in this repository and we'll handle it directly. If you have any questions please contact us at