By default, only 20 users will be returned in the response, always starting with the first user created. You can change this behaviour by using the limit and offset parameters.
Typically, deleted users are not included in the response. If you want to include these users then set the showDeleted parameter.
Parameters
limitinteger
Number of users that will be returned in the response. Default: 20.
offsetinteger
Offset to the first user to be returned in the response. Default: 0.
showDeletedinteger
Exclude users in the response that have been soft deleted. By default all users will be included whether they are deleted or not.
dateFromstring
Filter the response to users that have been created from and including this date. By default, all users will be incuded.
dateTostring
Filter the response to users that have been created up to and including this date. By default, all users will be incuded.
resellerRefinteger
Version 44 and above only. Return only users belonging to a particular reseller. The reseller must belong to your brand.
Response
Exceptions
invalidResellerRef
You are trying to filter by a reseller that does not belong to your brand.
Note that the brandRef must match that of the caller’s designated brand.
Typically, after you have created a user, a site is created for the user via Create Site.
Input
brandRefinteger
Required. Brand of the account holder.
firstNamestring
Required. 1-150 characters.
lastNamestring
Required. 1-150 characters.
usernamestring
Required. Username to be used to login the user to their account and sites. 1-255 characters.
passwordstring
Required. 7-100 characters. Prior to version 37 the maximum length was 19 characters.
emailstring
Required. E-mail address of the user. E-mails sent from the system in response to user lifecycle events (for example, subscription payment, renewal payments, cancellation, etc.) are sent to this address. 5-254 characters, of which the local part (example in example@domain.com) must be no more than 64 characters.
languageCodestring
Required. User’s language code. See List Brand Languages to determine the languages that are available.
resellerRefinteger
Optional. The reseller to which the user belongs.
metadataarray
Optional. Name and value pairs of user Metadata. Name 2-127 characters. Value 2-255 characters. Available from version 7.106.
This will only update the properties that have been included in the request. All properties that are missing from the request will remain the same.
Input
firstNamestring
1-150 characters.
lastNamestring
1-150 characters.
usernamestring
Username to be used to login the user to their account and sites. 1-255 characters.
passwordstring
7-100 characters. Prior to version 7.37 the maximum length was 19 characters.
emailstring
E-mail address of the user. E-mails sent from the system in response to user lifecycle events (for example, subscription payment, renewal payments, cancellation, etc.) are sent to this address. 5-255 characters.
languageCodestring
User’s language code. See List Brand Languages to determine the languages that are available.
The user is not deleted from the database, but it is marked for deletion and will not be included in further API calls unless deleted users are explicitly requested.
Automatically login an account holder to one of the sites that they own.
This method will return a secret hash string that can be used to provide a login URL to the user. The login URL will automatically log the user in to their website in the editor. If the site does not have a template yet then the user will arrive in the template picker.
If the site for login has URL www.example.com and the hash returned from this call is 0123456789abcdef then the login URL should be constructed as follows:
www.example.com?hash=0123456789abcdef
The hash string returned may only be used to login the user once. You must call this API method to generate a new hash code every time the user needs to login.
The hash string is only valid for 1 hour after the time that it is created.
Choosing a Template (v41 onwards)
After sign-up of a new account holder, and creation of their site, you may want to direct them to the template picker initially rather than the site editor.
Where partner.com is your url for the BaseKit platform, hash is replaced by the value returned by this call and the siteRef number is the ref returned when you created the account holder’s site.
You can choose what template categories or types are selected by default by appending the parameter %26selectedCategory=travel or %26selectedType=blog to the above URL.
So to login an account holder, direct them straight to the template picker and show the category travel you would redirect to the following URL:
A user may only have one subscription package. It is possible for a user to have multiple packages of other types, but most brands do not support this functionality.
Associate a package to the specified user. The user will inherit all the features and capabilities that are available in the package.
This method is used for Subscription, Upgrade, Downgrade and Cancellation.
A user may only have one subscription package. If a new subscription package is associated with their account via this method then the existing subscription package is automatically removed.
Input
packageRefinteger
Required. Package to add
billingFrequencyinteger
Value is in months. Typically this will be 1 for monthly or 12 for annual, but it can be any number. It is critical that the correct billing frequency is passed in as this is used for provisioning and billing of the user.
Response will be empty with a HTTP status code of 102 Processing until job has completed.
Jobs will be held for 1 hour after completion before result is deleted.