Create

Creates a Hire Group Campaign.

Request

POST https://ttv.microworkers.com/api/v2/hire-group-campaigns

Request Body

{
  "availablePositions": integer,
  "categoryId": string,
  "groupId": string,
  "maxPositionPerWorker": integer,
  "numberOfWorkerOnSamePosition": integer,
  "internalTemplate": {
    "id": string,
    "adminInstructions": string,
    "numberOfSubTasks": integer,
    "ratingMethodId": integer,
    "displaySubTasksOnSamePage": boolean,
    "allowedFileTypes": [
      string
    ],
    "numberOfFileProofs": integer
  },
  "externalTemplate": {
    "url": string,
    "height": string,
    "width": string,
    "parameters": [
      string
    ],
    "timeToWaitAfterSlotExpiration": integer
  },
  "minutesToFinish": integer,
  "title": string,
  "qtRequired": boolean,
  "description": string,
  "paymentPerTask": float,
  "maximumJobLimit": {
    "enabled": boolean,
    "limitPerDay": integer,
    "distributionType": string,
    "advancedSchedule": {
      "timeZone": string,
      "limitPerHour": integer,
      "events": [
        {
          "type": string,
          "daysOfWeek": [
            integer
          ],
          "startTime": string,
          "endTime": string,
          "startRecur": datetime,
          "endRecur": datetime,
          "limitPerDay": integer,
          "limitPerHour": integer
        },
        {
          "type": string,
          "start": datetime,
          "end": datetime,
          "allDay": boolean,
          "limitPerDay": integer,
          "limitPerHour": integer
        }
      ]
    },
    "standardSchedule": {
      "timeZone": string,
      "limitPerHour": integer,
      "allDay": boolean,
      "allWeekdays": boolean,
      "daysOfWeek": [
        integer
      ],
      "workingHours": [
        string
      ]
    }
  },
   "autoSkipTask": {
    "enabled": boolean,
    "timeLimit": integer
  },
  "ttr": integer,
  "taskOrder": integer,
  "tasks": [
    {
      "id": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ],
      "testCases": [
        {
          "questionId": string,
          "answers": [
            string
          ]
        }
      ]
    }
  ],
  "notificationSettings": [
    {
      "url": string,
      "type": string,
      "notificationTypes": [
        string
      ]
    }
  ],
  "visibilityDelay": integer
}

HireGroupCampaignPostRequest

Property	Type	Description
availablePositions	integer	How many initial positions Campaign has.
categoryId	string	The ID of Category which best match to your Task requirements.
groupId	string	Hire Group (Group of Workers) ID which best match to your Task requirements.
maxPositionPerWorker	integer	How many positions each worker can take. 0 – unlimited. [1]
numberOfWorkerOnSamePosition	integer	How many workers should complete same position. Required, if Campaign utilize unique positions.
internalTemplate	InternalTemplateRequest	Internal Template Campaign settings. internalTemplate cannot be used together with externalTemplate.
externalTemplate	ExternalTemplateRequest	External Template Campaign settings. externalTemplate cannot be used together with internalTemplate
minutesToFinish	integer	Allocated time in minutes to complete position.
title	string	The title of Campaign.
qtRequired	boolean	If set to true, only workers who passed Microworkers Qualification/Admission test [2] will be able to work on Tasks from this Campaign.
description	string	Campaign description which will be shown to worker on accept/start Task page.
paymentPerTask	float	How much money worker will earn in American $ for Satisfied Task.
maximumJobLimit	MaximumJobLimitRequest	Max Positions per Day settings. [3]
ttr	integer	Limit in days allocated to Employer to rate submitted Task. If Task wasn’t rated on time – it will be automatically rated as Satisfied.
taskOrder	integer	Order in which Tasks will be assigned to workers. [4] 1 – Random 2 – Ascending order Required, if Campaign utilize unique positions.
tasks	array[TaskDataRowRequest]	A list of Tasks details. Required, if Campaign utilize unique positions.
notificationSettings	array[AmazonSqsNotificationSettingRequest]	A list of notifications settings.
autoSkipTask	AutoSkipTaskRequest	Auto-skip position settings.
visibilityDelay	integer	The number of seconds to wait after adding new position/s, before making it available to the Workers. Default: 0 (No Delay). Maximum: 3600.

InternalTemplateRequest

Property	Type	Description
id	string	The ID of Template (Internal).
adminInstructions	string	Instructions to Microworkers staff how to review/rate Tasks. Required if ratingMethodId is 1 or 2. If ratingMethodId is 3 – must be omitted.
numberOfSubTasks	integer	Number of Tasks each position has. Required, if Campaign utilize unique Tasks, in other cases – it must be absent.
ratingMethodId	integer	1 - Admin Rate 2 - Admin Review & Employer Rate 3 - Employer Rate Only. [5]
displaySubTasksOnSamePage	boolean	Display Spreadsheet [6] sub-tasks on same page flag. Required, If Template has Spreadsheet, in all other cases must be absent.
allowedFileTypes	array[string]	A list of allowed file extensions.
numberOfFileProofs	integer	Value can be in range 1 to 3.

ExternalTemplateRequest

Property	Type	Description
url	string	URL of Task details page which will be displayed in iframe. Required, if Campaign doesn’t utilize unique positions.
height	string	Iframe height. Required, if Campaign doesn’t utilize unique positions.
width	string	Iframe width. Required, if Campaign doesn’t utilize unique positions.
parameters	array[string]	A list of parameters you wish to store on submission to Callback URL [7] .
timeToWaitAfterSlotExpiration	integer	How many minutes to wait to release lock from the Slot with expired lock.

MaximumJobLimitRequest

Property	Type	Description
enabled	boolean	Flag which controls if maximum positions per day is turned on.
limitPerDay	integer	Maximum number of positions which may be completed on daily basis. Required if maximum positions per day is turned on.
distributionType	string	Distribution type. random or asap. Default: random.
advancedSchedule	AdvancedScheduleResponse	Advanced schedule. Cannot be used together with standardSchedule.
standardSchedule	StandardScheduleResponse	Standard schedule. Cannot be used together with advancedSchedule.

AdvancedScheduleResponse

Property	Type	Description
timeZone	string	Relative Timezone.
limitPerHour	integer	Maximum accepted jobs per hour.
events	array[RecurEventResponse or OneTimeEventResponse]	List of events.

RecurEventResponse

Property	Type	Description
type	string	Fixed value: recur.
daysOfWeek	array[integer]	Day of week, positions are available. 0 - Sunday, 6 - Saturday.
startTime	string	Start time. Format: HH:00.
endTime	string	End time. Format: HH:00.
startRecur	datetime	Start date.
endRecur	datetime	End date.
limitPerDay	integer	Number of positions available per day.
limitPerHour	integer	Number of positions available per hour.

OneTimeEventResponse

Property	Type	Description
type	string	Fixed value: one-time.
start	datetime	Start date/time.
end	datetime	End date/time.
allDay	boolean	Positions are available 24 hours a day in specified date/time range.
limitPerDay	integer	Number of positions available per day.
limitPerHour	integer	Number of positions available per hour.

StandardScheduleResponse

Property	Type	Description
timeZone	string	Relative Timezone.
limitPerDay	integer	Number of positions available per day.
allDay	boolean	Flag which controls whether positions are available 24 hours a day.
allWeekDays	boolean	Flag which controls whether positions are available every day of the week.
daysOfWeek	array[integer]	Day of week, positions are available. 0 - Sunday, 6 - Saturday. Required if allWeekDays is false.
workingHours	array[string]	Hours of the day positions are available. Required if allDay is false.

TaskDataRowRequest

Property	Type	Description
id	string	The ID of Task. If present - value must be unique and contain alpha-numeric characters only. If it’s omitted - system will generate random value
data	array[KeyValueRequest]	The list of key/value objects.
testCases	array[TestCaseRequest]	The list of expected Answers for Questions.

AmazonSqsNotificationSettingRequest

Property	Type	Description
url	string	Amazon SQS Queue URL
type	string	Notification settings type. Fixed value: sqs.
notificationTypes	array[string]	List of turned on Notification Types.

KeyValueRequest

Property	Type	Description
key	string	Key
value	string	Value

TestCaseRequest

Property	Type	Description
questionId	string	The ID of Question.
answers	array[string]	The list of expected Answers.

AutoSkipTaskRequest

Property	Type	Description
enabled	boolean	Flag which controls If auto-skip position is turned on.
timeLimit	integer	If browser didn’t refresh the session within allocated time in seconds – position will be auto-skipped. Required if auto-skip position flag is turned on.

Notification Types

Notification Type
CampaignApproved	CampaignPausedByAdmin	CampaignRunning	SlotNotSatisfied	SlotSubmitted
CampaignBlocked	CampaignPausedBySystem	CampaignSubmitted	SlotReadyForRating	TaskGroupCreated
CampaignCanceled	CampaignRejected	SlotCreated	SlotRemoved
CampaignCreated	CampaignRestartApproved	SlotLocked	SlotRevised
CampaignFinished	CampaignRestartRejected	SlotLockExpired	SlotReviseRequested
CampaignPaused	CampaignRestartRequested	SlotLockReleased	SlotSatisfied

Response

Response HTTP Codes

Http Code	Response Type	Description
202		Accepted (OK)
400		Validation Failed
401		Unauthorized

Response HTTP Headers

On successful response API returns queue-job-id header.

Examples

Internal Template - fixed task details

Settings:

• Fixed Task details.

• 10 initial positions.

• SEO & Web Traffic Category.

• I want to rate Tasks ASAP. (Employer rate) [5]

• 5 minutes allowed for Worker to complete the position.

• Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.10 for satisfied position.

• Allocated time to rate position - 2 days.

• I want to assign this Campaign to “MW: English Speaking Countries” Hire Group (Default).

• Each Worker can take 1 position only.

{
  "availablePositions": 10,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 3
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 2,
  "groupId": "18f477773330",
  "maxPositionPerWorker": 1
}

Internal Template - unique task details

Settings:

• Unique Task details.

• 10 initial positions.

• Data Transcription Category.

• I want Microworkers Staff to review positions before they will come to me for rating (Admin review, Employer rate) [5]

• Each position has 1 Task.

• 30 minutes allowed for Worker to complete the position.

• Disallow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.50 for satisfied position.

• Allocated time to rate position - 5 days.

• I want to assign this Campaign to “Favorite” Hire Group (Custom).

• Each Worker can take 2 positions.

• I want to assign each position to 3 unique Workers.

• Tasks will be allocated to Workers in ascending order. [4]

{
  "availablePositions": 10,
  "categoryId": "07",
  "internalTemplate": {
    "id": "T58b74ba469d61",
    "ratingMethodId": 2,
    "adminInstructions": "Review completed tasks carefully and rejects these which don't match.",
    "numberOfSubTasks": 1
  },
  "minutesToFinish": 30,
  "title": "Audio Transcription",
  "qtRequired": true,
  "description": "You need to transcript 5 minutes length audio file.",
  "paymentPerTask": 0.5,
  "ttr": 5,
  "groupId": "ioReem0BAhm4",
  "maxPositionPerWorker": 2,
  "numberOfWorkerOnSamePosition": 3,
  "taskOrder": 2,
  "tasks": [
    {
      "id": "1",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "2",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "3",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "4",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "5",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "6",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "7",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "8",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "9",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "10",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    }
  ]
}

Internal Template - File proof with file type restrictions

Settings:

• Fixed Task details.

• 5 initial positions.

• SEO & Web Traffic Category.

• I don’t have time to rate positions and would like to assign this to Microworkers Staff. (Admin rate) [5]

• Worker must upload 2 screenshots as confirmation. File types allowed: JPG, JPEG, GIF, TIFF and PNG.

• 5 minutes allowed for Worker to complete the position.

• Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.15 for satisfied position.

• Allocated time to rate position - 1 day.

• I want to assign this Campaign to “Favorite” Hire Group (Custom).

• Each Worker can take 1 position only.

{
  "availablePositions": 5,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 1,
    "adminInstructions": "Company logo must be present on the screenshot provided by Worker.",
    "allowedFileTypes": [
      "jpg",
      "jpeg",
      "gif",
      "tiff",
      "png"
    ],
    "numberOfFileProofs": 2
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.15,
  "ttr": 1,
  "groupId": "ioReem0BAhm4",
  "maxPositionPerWorker": 1
}

Internal Template (Spreadsheet) [6]

Settings:

• Unique Task details.

• 5 initial positions.

• Data Collection/Mining/Extraction/AI Training Category.

• I want to rate positions myself. (Employer rate) [5]

• Every position has 2 Tasks which should be displayed in Spreadsheet [6] on same page.

• 5 minutes allowed for Worker to complete the position.

• Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.04 for satisfied position.

• Allocated time to rate position - 1 day.

• I want to assign this Campaign to “MW: Data Services” Hire Group (Default).

• Each Worker can take unlimited number of positions.

• I want to assign each position to 2 unique Workers.

• Tasks will be allocated to Workers in random order. [4]

{
  "availablePositions": 5,
  "categoryId": "09",
  "internalTemplate": {
    "id": "T56b259b765593",
    "ratingMethodId": 3,
    "displaySubTasksOnSamePage": true,
    "numberOfSubTasks": 2
  },
  "minutesToFinish": 5,
  "title": "Collect university name from URL",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.04,
  "ttr": 1,
  "groupId": "80f83edc0558",
  "maxPositionPerWorker": 0,
  "numberOfWorkerOnSamePosition": 2,
  "taskOrder": 1,
  "tasks": [
    {
      "id": "1",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/www.yundt.com\/laboriosam-ut-inventore-suscipit-iusto-at-dolor-veritatis-eos"
        },
        {
          "key": "name",
          "value": "Hayes Group"
        },
        {
          "key": "employees_name",
          "value": "Rylee Cummerata DVM"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "2",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/quitzon.com\/non-molestiae-quidem-ea-illo-est"
        },
        {
          "key": "name",
          "value": "Wintheiser LLC"
        },
        {
          "key": "employees_name",
          "value": "Mrs. Maida Pacocha IV"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "3",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/goodwin.net\/qui-et-est-unde-et-incidunt-maiores.html"
        },
        {
          "key": "name",
          "value": "Barton, Treutel and Legros"
        },
        {
          "key": "employees_name",
          "value": "Amir Bogisich"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "4",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/block.com\/nisi-inventore-nisi-eos-esse-quia-cum-doloremque"
        },
        {
          "key": "name",
          "value": "Lebsack Group"
        },
        {
          "key": "employees_name",
          "value": "Fletcher Durgan"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "5",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/www.okeefe.org\/"
        },
        {
          "key": "name",
          "value": "Gleason-Muller"
        },
        {
          "key": "employees_name",
          "value": "Leonardo Keebler I"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "6",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/klein.com\/incidunt-rerum-adipisci-est-cumque-veritatis-tempora-placeat.html"
        },
        {
          "key": "name",
          "value": "Walker-Bartoletti"
        },
        {
          "key": "employees_name",
          "value": "Greta Schiller"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "7",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/pacocha.info\/"
        },
        {
          "key": "name",
          "value": "Parker-Gutmann"
        },
        {
          "key": "employees_name",
          "value": "Bud Steuber"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "8",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/www.king.net\/"
        },
        {
          "key": "name",
          "value": "Will, Schulist and Pacocha"
        },
        {
          "key": "employees_name",
          "value": "Yessenia Hessel"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "9",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/hand.org\/et-libero-ut-ut-quia-aspernatur-et.html"
        },
        {
          "key": "name",
          "value": "Little LLC"
        },
        {
          "key": "employees_name",
          "value": "Kirsten Gaylord"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "10",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/schoen.com\/accusantium-qui-qui-quae-id-laboriosam-facilis"
        },
        {
          "key": "name",
          "value": "Dach Ltd"
        },
        {
          "key": "employees_name",
          "value": "Perry Shanahan III"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    }
  ]
}

Internal Template - Amazon SQS Notifications

Settings:

• Fixed Task details.

• 30 initial positions.

• SEO & Web Traffic Category.

• I want to rate Tasks ASAP. (Employer rate) [5]

• 5 minutes allowed for Worker to complete the position.

• Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.10 for satisfied position.

• Allocated time to rate position - 2 days.

• I want to assign this Campaign to “MW: Data Services” Hire Group (Default).

• Each Worker can take 1 position.

• I want to be notified via Amazon SQS when position is ready for rating and when Campaign is finished.

• I configured https://sqs.us-east-1.amazonaws.com/12345678/myqueue Queue and granted SendMessage permission to arn:aws:iam::017419115111:user/akanunov.

{
  "availablePositions": 30,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 3
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 2,
  "groupId": "80f83edc0558",
  "maxPositionPerWorker": 1,
  "notificationSettings": [
    {
      "url": "https://sqs.us-east-1.amazonaws.com/12345678/myqueue",
      "type": "sqs",
      "notificationTypes": [
        "CampaignFinished",
        "SlotReadyForRating"
      ]
    }
  ]
}

Internal Template - Maximum jobs per day limit - Basic mode [3]

Settings:

• Fixed Task details.

• 50 initial positions.

• SEO & Web Traffic Category.

• I want to rate Tasks myself. (Employer rate) [5]

• 5 minutes allowed for Worker to complete the position.

• Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.10 for satisfied position.

• Allocated time to rate position - 2 days.

• I want to assign this Campaign to “MW: Global Users” Hire Group (Default).

• Each Worker can take 1 position.

• I want to allow Workers to complete up to 5 positions per day.

{
  "availablePositions": 50,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 3
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 2,
  "groupId": "18f477774339",
  "maxPositionPerWorker": 1,
  "maximumJobLimit": {
    "enabled": true,
    "limitPerDay": 5
  }
}

Internal Template - Maximum jobs per day limit - Standard mode [3]

Settings:

• Fixed Task details.

• 50 initial positions.

• SEO & Web Traffic Category.

• I want to rate Tasks myself. (Employer rate) [5]

• 5 minutes allowed for Worker to complete the position.

• Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.10 for satisfied position.

• Allocated time to rate position - 2 days.

• I want to assign this Campaign to “MW: Global Users” Hire Group (Default).

• Each Worker can take 1 position.

• I want to allow Workers to complete up to 5 positions per day.

• I want to limit workers by working on specific days: Monday - Friday

• I want to limit workers by working at specific hours: 9AM - 5PM(exclusive)

{
  "availablePositions": 50,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 3
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 2,
  "groupId": "18f477774339",
  "maxPositionPerWorker": 1,
  "maximumJobLimit": {
    "enabled": true,
    "limitPerDay": 5,
    "standardSchedule": {
      "allDay": false,
      "allWeekdays": false,
      "daysOfWeek": [
        1,2,3,4,5
      ],
      "workingHours": [
        "09","10","11","12",
        "13","14","15","16"
      ]
    }
  }
}

Internal Template - Maximum jobs per day limit - Advanced mode [3]

Settings:

• Fixed Task details.

• 50 initial positions.

• SEO & Web Traffic Category.

• I want to rate Tasks myself. (Employer rate) [5]

• 5 minutes allowed for Worker to complete the position.

• Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.10 for satisfied position.

• Allocated time to rate position - 2 days.

• I want to assign this Campaign to “MW: Global Users” Hire Group (Default).

• Each Worker can take 1 position.

• I want to allow Workers to complete up to 5 positions per day.

• I want to limit workers by working every Sunday of 2024, at specific hours: 9AM - 3PM(exclusive).

• I want to limit workers by working whole day on 15th October 2024.

{
  "availablePositions": 50,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 3
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 2,
  "groupId": "18f477774339",
  "maxPositionPerWorker": 1,
  "maximumJobLimit": {
    "enabled": true,
    "limitPerDay": 5,
    "advancedSchedule": {
      "events": [
        {
          "type": "recur",
          "daysOfWeek": [
            0
          ],
          "startTime": "09:00",
          "endTime": "15:00",
          "startRecur": "2024-01-01",
          "endRecur": "2024-12-31"
        },
        {
          "type": "one-time",
          "start": "2024-10-15 00:00:00",
          "end": "2024-10-16 00:00:00",
          "allDay": true
        }
      ]
    }
  }
}

External Template - fixed task details

Settings:

• Fixed Task details.

• 30 initial positions.

• SEO & Web Traffic Category.

• I have a website where I prepared Task details page.

• My website uses HTTPS protocol.

• My Task details page doesn’t return X-Frame-Options DENY or SAMEORIGIN HTTP header.

• Task details page will post data back to Microworkers [7].

• I want to store contact_email parameter value on Microworkers side.

• 5 minutes allowed for Worker to complete the position.

• Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.10 for satisfied position.

• Allocated time to rate position - 1 day.

• I want to assign this Campaign to “MW: Data Services” Hire Group (Default).

• Each Worker can take 1 position.

{
  "availablePositions": 30,
  "categoryId": "10",
  "externalTemplate": {
    "url": "https://mywebsite.com/microworkers-task/{{CAMP_ID}}?worker_id={{MW_ID}}&random_key={{RAND_KEY}}",
    "height": "500px",
    "width": "100%",
    "parameters": [
      "contact_email"
    ]
  },
  "minutesToFinish": 5,
  "title": "Find contact email on website",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 1,
  "groupId": "80f83edc0558",
  "maxPositionPerWorker": 1
}

External Template - unique task details

Settings:

• Unique Task details.

• 5 initial positions.

• Data Transcription Category.

• 30 minutes allowed for Worker to complete the position.

• Disallow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.50 for satisfied position.

• Allocated time to rate position - 5 days.

• I want to assign this Campaign to “MW: English Speaking Countries” Hire Group (Default).

• Each Worker can take unlimited number of positions.

• I want to assign each position to 3 unique Workers.

• Tasks will be allocated to Workers in ascending order. [4]

• I have a website where I prepared Task details pages.

• My website uses HTTPS protocol.

• My Task details pages doen’t return X-Frame-Options DENY or SAMEORIGIN HTTP header.

• Task details pages will post data back to Microworkers [7].

• From privacy perspective I don’t want to store any Answers provided by Workers on Microworkers side.

{
  "availablePositions": 5,
  "categoryId": "07",
  "minutesToFinish": 30,
  "title": "Audio Transcription",
  "qtRequired": true,
  "description": "You need to transcript 5 minutes length audio file.",
  "paymentPerTask": 0.5,
  "ttr": 5,
  "groupId": "18f477773330",
  "maxPositionPerWorker": 0,
  "numberOfWorkerOnSamePosition": 3,
  "taskOrder": 2,
  "tasks": [
      {
        "id": "1",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b542222-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      },
      {
        "id": "2",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b5424fc-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      },
      {
        "id": "3",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b54284e-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      },
      {
        "id": "4",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b5429a2-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      },
      {
        "id": "5",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b542ae2-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      }
   ]
}

External Template - Amazon SQS Notifications

Settings:

• Fixed Task details.

• 7 initial positions.

• SEO & Web Traffic Category.

• I have a website where I prepared Task details page.

• My website uses HTTPS protocol.

• My Task details page doesn’t return X-Frame-Options DENY or SAMEORIGIN HTTP header.

• Task details page will post data back to Microworkers [7].

• I want to store contact_email parameter value on Microworkers side.

• 5 minutes allowed for Worker to complete the position.

• Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.

• Worker base earning $0.10 for satisfied position.

• Allocated time to rate position - 1 day.

• I want to assign this Campaign to “MW: English Speaking Countries” Hire Group (Default).

• Each Worker can take 1 position.

• I want to be notified via Amazon SQS on any Slot status change.

• I configured https://sqs.us-east-1.amazonaws.com/12345678/myqueue Queue and granted SendMessage permission to arn:aws:iam::017419115111:user/akanunov.

{
  "availablePositions": 7,
  "categoryId": "10",
  "externalTemplate": {
    "url": "https://mywebsite.com/microworkers-task/{{CAMP_ID}}?worker_id={{MW_ID}}&rand_key={{RAND_KEY}}",
    "height": "500px",
    "width": "100%",
    "parameters": [
      "contact_email"
    ]
  },
  "minutesToFinish": 5,
  "title": "Find contact email on website",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 1,
  "groupId": "18f477773330",
  "maxPositionPerWorker": 1,
  "notificationSettings": [
    {
      "url": "https://sqs.us-east-1.amazonaws.com/12345678/myqueue",
      "type": "sqs",
      "notificationTypes": [
        "SlotReadyForRating",
        "SlotRemoved",
        "SlotLocked",
        "SlotRevised",
        "SlotLockExpired",
        "SlotReviseRequested",
        "SlotLockReleased",
        "SlotSatisfied"
      ]
    }
  ]
}

[1]

Multiple Workers In One Task Microworkers Blog.

[2]

“QT Optional” Feature Microworkers Blog.

[3]

Max Positions per Day Microworkers Blog.

[4]

Display Tasks in Random, Collect Organized Results Microworkers Blog.

[5]

Checking and Rating Submitted Tasks on TTV Microworkers Blog.

[6]

Default Spreadsheet Templates Microworkers Blog.

[7]

Submit Proof URL For External Template Campaign.