Enabling participation requests

You can provide a link that enables your participants to register to test your app.

About this task

There might be situations when you want to send an invitation to a large number of potential testers, but you do not expect them all to be able to participate. In this case, you can create a unique link for that app that the participant can select to have the request added to a waiting list for the participants list. This can also be helpful if you are trying to select your participants based on certain locations. To prepare the participation requests, complete the following procedure:

Procedure

Select the WAITING LIST tab on the PARTICIPANTS AND GROUPS MANAGEMENT page. If this is your first time setting up the Waiting List, the page does not contain any participant entries. The Waiting Room API URL is displayed, which is used to enable the Waiting List feature.
Create a POST request that is sent to the Waiting Room API URL that contains the following information:
email

This is required, and provides the email address of the participant.

platform

This optional metadata specifies the platform operating system of the participant, which can be either ios or android.

os_version

This optional metadata specifies the version of the operating system that the participant is using.

ip_address

This optional metadata specifies the IP address of the participant.

locale

This optional metadata indicates the locale that the participant used when registering.

device_type

This optional metadata specifies the type of device that the participant was using when registering.

The following example shows the possible formatting of a POST request:
```
POST your_Waiting_Room_API_URL_goes_here
Content-Type: application/json
Host: https://beta.ibm.com
Accept: application/json
User-Agent: Mozilla/5.0 (Linux; Android 4.0.4; Galaxy Nexus Build/IMM76B; en_US) AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.133 Mobile Safari/535.19
{
 "email" : "beta@example.com" ,
 "metadata" : {
  "platform" : "ios" ,
  "os_version" : "9.0" ,
  "ip_address" : "123.234.123.234" ,
  "locale" : "en_US" ,
  "device_type" : "phone"
 }
}
```
Optional: Create a landing page where participants can register for your testing. This page can provide a better user experience for participants who register for your testing. They can enter all of the required and optional information, which is organized and sent to the required URL.