The NotifyWorkers operation sends e-mail to
one or more Workers, given the recipients' Worker IDs.
Worker IDs are included in the assignment data returned by
GetAssignmentsForHIT. You can send e-mail
to any Worker who has ever submitted results for a HIT you
created that you have approved or rejected.
The e-mail sent to Workers includes your e-mail address as the "reply-to" address, so Workers can respond to the e-mail. You can change the e-mail address for your account using the Requester Console (http://requester.mturk.amazon.com/) by selecting "Your Account" from the navigation bar.
Up to 100 Worker IDs can be sent the same message with a single
call to NotifyWorkers.
The following example of a call to the
NotifyWorkers operation sends an e-mail
message to three Workers.
http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID]&Version=2006-08-23 &Operation=NotifyWorkers &Signature=[signature for this request]&Timestamp=[your system's local time]&Subject=Thank%20you &MessageText=Hello!%20Just%20wanted%20to%20say%20thank%20you... &WorkerId.1=AZ3123EXAMPLE &WorkerId.2=AZ3456EXAMPLE &WorkerId.3=AZ3789EXAMPLE
A request to the Mechanical Turk Service includes parameters that control its behavior and the data it returns. Required parameters must be included for the request to succeed.
NotifyWorkers accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.
The following parameters are specific to the NotifyWorkers operation:
| Name | Description | Type | Value |
|---|---|---|---|
Operation
|
The operation you would like to call. To access the
| Required |
|
Subject
|
The subject line of the e-mail message to send. It can include up to 200 characters. | Required |
A string |
MessageText
|
The text of the e-mail message to send. It can include up to 2,000 characters. | Required |
A string |
WorkerId
|
The ID of the Worker to notify, as returned by
| Required |
A valid Worker ID |