Getting Started with MOLOCO Cloud API
This page will help you get started with MOLOCO Cloud API.
Prerequisite
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:
https://www.moloco.com/en/contact
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"}' \
https://api.moloco.cloud/cm/v1/auth/tokens
{
"token":"$TOKEN"
}
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.
Updated 4 months ago