AssociateQualificationWithWorker - Amazon Mechanical Turk



The AssociateQualificationWithWorker operation gives a Worker a Qualification. AssociateQualificationWithWorker does not require that the Worker submit a Qualification request. It immediately gives the Worker the Qualification.

You can only assign a Qualification of a Qualification type that you created (using the CreateQualificationType operation).


AssociateQualificationWithWorker does not affect any pending Qualification requests for the Qualification by the Worker. If you associate a Qualification to a Worker, then later accept a Qualification request made by the Worker, accepting the request may modify the Qualification score. To resolve a pending Qualification request without affecting the Qualification the Worker already has, reject the request with the RejectQualificationRequest operation.

Request Syntax

{ "QualificationTypeId": String, "WorkerId": String, "IntegerValue": Integer, "SendNotification": Boolean }

Request Parameters

The request accepts the following data in JSON format:

Name Description Required


The ID of the Qualification type to use for the assigned Qualification.

Type: String

Constraints: must be a valid Qualification type ID, as returned by the CreateQualificationType operation.



The ID of the Worker to whom the Qualification is being assigned. Worker IDs are included with submitted HIT assignments and Qualification requests.

Type: String



The value of the Qualification to assign.

Type: Integer

Default: 1



Specifies whether to send a notification email message to the Worker saying that the qualification was assigned to the Worker.

Type: Boolean

Default: true


Response Elements

A successful request for the AssociateQualificationWithWorker operation returns with no errors and an empty body.


The following example shows how to use the AssociateQualificationWithWorker operation:

Sample Request

The following example grants a Qualification to a Worker.

POST / HTTP/1.1 Host: Content-Length: <PayloadSizeBytes> X-Amz-Date: <Date> { WorkerId:"AZ3456EXAMPLE", QualificationTypeId:"789RVWYBAZW00EXAMPLE", IntegerValue:1, SendNotification:false }

Sample Response

The following is an example response:

HTTP/1.1 200 OK x-amzn-RequestId: <RequestId> Content-Type: application/x-amz-json-1.1 Content-Length: <PayloadSizeBytes> Date: <Date>