Getting Started with MOLOCO Cloud API

This page will help you get started with MOLOCO Cloud API.


To call the MOLOCO Cloud API, you need to sign in as a MOLOCO Cloud user. If you don't have an account, please contact our customer service to issue the account:

We will create your account and register it to a workplace. Workplace is where you manage your advertisement campaigns.

Once your account is created, you will receive a password reset email. Please update your password using the link enclosed in the email before actually starting to use the account.

Once you have your account ready, you can issue a MOLOCO Cloud API Access Token programmatically. With the token, you can call the MOLOCO Cloud APIs. Please see the following example. In the example, $EMAIL and $PASSWORD are your email address and password. $WORKPLACE_ID is the ID of the workplace that we registered your account to.

$ curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"workplace_id":"$WORKPLACE_ID","email":"$EMAIL","password":"$PASSWORD"}' \


In the JSON response body, you can find the access token from the token field ($TOKEN). In the subsequent calls to the MOLOCO Cloud API endpoints, you should put this token to the Authorization header in the following manner:

Authorization: Bearer $TOKEN

If you don't place the right token, your calls will be rejected.
For a detailed description of token creation, see Create a new token.

Please note that the token is valid for 1 hour. Therefore, it is recommended to periodically refresh the token before it expires. See Refresh the existing token.

What’s Next