Link Search Menu Expand Document

user.createUser

Creates a new user.

Example URL

https://api.melodia.io/v1/user.createUser?userKey=a4b5G982H3r9Vf783EEd

Params

paramrequireddescriptiontype
userKeyNA unique ID to be associated with the new userString
countryCodeNTwo-letter country code associated with new userString
secondsFromGMTNDifference in seconds between user’s time zone and Greenwich Mean Time. Defaults to -25200 (PST).Int

Auth

This service requires authentication. Refer to Authentication for more details.

Sample Response

{
    'statusCode': 200,
    'body': {
       'userKey': "Ndk378FlwkdU3gjw"
    }
}

Discussion

Melodia’s music recommendation is centered around the individual user. As such, before any recommendations can be made, a user must first be defined.

The user.createNewUser method creates a new user on your platform. Once created, the method returns a unique ID associated with the new user, which can then be used to make personalized calls to other methods. Optionally, you may choose to provide a custom ID to create the new user using the userKey request parameter. If a custom ID is provided, it must be unique to your platform, otherwise the call will fail.