API Reference


User methods allow you display, create, remove and manipulate user accounts within New Spark Media Platform.
Users.confirmCredentials

Confirms a users username and password, and optionally returns user information.

If returnUserInfo is set to false, this method will return the user id when the settings were correct. This method always returns false when username or password is incorrect.

If login is set to true a session will be started and the system will return a sessiontoken property in the userData struct. read more »

Users.getBlockedUsers

Get a list of blocked Users by user id

read more »
Users.getPowerUserRanking
If bylike is set to False.
This method will return a list of users, sorted by their submissions over 7 or 30 days.
f bylike is set to True
This method will return a list of users, sorted by amount of likes on their submissions over 7 or 30 days.
read more »
Users.getUserInfo

Returns information about a specific user.

This method returns all available information about a requested user based on either a user ID or a username. The method requires a user ID or a username. If a username is supplied the vhost parameter is required.

read more »
Users.getUserInfoByDeviceID
This method will return the user information related to the owner of a particular mobile device. read more »
Users.getUserInfoByExternalID

This method returns all available information about a requested user based on an exernal user ID. The method requires an external user ID and vhost.

read more »
Users.getUserInfoByPhone
This method returns all available user information about a specific user based on the required phone number . This method requires a valid phone number and a vhost ID. read more »
Users.getUsers

Returns an array of users with standard information and metadata. Also returns userCount - the number of users found in the search.

read more »
Users.inviteUsers

This will store a list of users and/or emails that will trigger a notification when the user joins the project.

read more »
Users.register

This method registers a new user.

Optionally the user can be activated immediately. If the email parameter contains a string, an email template named by that string will used to send out an activation or welcome email.

The return value is the newly created user id.

This method can only be called with a valid developer key.

Required fields for userData are user and read more »

Users.registerOrUpdate

This method registers a new user or updates an existing user if it already exists and returns the user's ID.

The userData is optional, and can be used to update user information if needed. The "userName" parameter will be used as the primary key here. The username may not be updated through this service call; it will only be used if a new user is being registered.

The "userName" read more »

Users.updateUserInfo

Updates a user's information personal information and metadata.

The meta data field is a bit special. The meta field must be supplied as an array. The new user meta-data will be a merge of the existing meta-date + the newly supplied metadata. Only the top-level elements in the array will be merged, if you have an array within an array, the old top-level array will be completely read more »