Help > Forum > Website Integration > Automatic Registration

Automatic Registration

Automatic Registration allows you to send an HTTP request from within your application to automatically create a user's forum account. This can be helpful if you have a separate registration on your website and you don't want to make your visitors register twice.

If you are using PHP, we highly recommend using our SSO Library. It contains one file with all of the library code you?ll need and other files with example usage.

You can optionally turn off new registrations so that users can't directly create accounts. Then the only way to create a new account would be to invite the user or create the account programmatically using the instructions mentioned in this support article. That may be helpful if you would like to ensure that new accounts can only be created through your website.

Sending a registration request is optional since accounts will be created automatically if they don't already exist during a single sign on log in request.

If you need help, our developers can setup Single Sign On integration on your website for just $149. Contact Us



If you would like to automatically create the forum user's account, please follow the directions below:

The URL should look like this unmodified:

https://USERNAME.websitetoolbox.com/register/create_account?type=json&apikey=APIKEY

Notes:
  • Replace USERNAME.websitetoolbox.com with your forum address.
  • Replace APIKEY with your forum API Key.
Then extend the URL with whatever information you would like. The appropriate extensions are listed at the bottom of the page. Please note that the username, password, and email address fields are required.

The response from the server will be in JSON format similar to this:

{
  "userid": "The numerical userid of the newly registered user will be here."
}

If an error occurs during the regitration, the JSON response will look like this:

{
  "message": "The error message will be here."
}

In the Settings -> Single Sign On section of your Website Toolbox account, specify the address of your website's Registration Page to ensure that all forum registrations occur using your website's registration form.

The next step is to integrate your website's log in and log out process.



If you would like to send your visitors to the registration page with the textboxes already filled in, please follow the directions below:

The URL should look like this unmodified:
https://USERNAME.websitetoolbox.com/register/register?passvalues=1
(Replace USERNAME.websitetoolbox.com with your forum address.)

Then extend the URL with whatever information you would like pre-filled. The appropriate extensions are listed at the bottom of the page.



Field Extension Possible Values
Username &member= Anything besides spaces or symbols
Password &pw= Anything besides spaces, semicolons, or commas. Unencrypted.
Email &email= A valid email address
Full name &name= Anything
User Group ID &usergroupid= The ID number of the user group to assign to the user. Example: 3729047
Instant messaging type &imType= None, Yahoo, ICQ, AOL, MSN, Other
Instant messaging name &imID= Anything
Avatar URL &avatar= A URL to a GIF, JPEG, JPG, or PNG image
Signature &signature= Anything

Fields created in the Users -> Fields section of your Website Toolbox account have their own unique extension (or field name), which can be determined by viewing the HTML source code of the registration page.

Note that the query string must be URL-encoded.


If you still need help, please contact us.