Connecting your TurkPrime to your Mechanical Turk account is easy and should not take more than a few minutes.
Now that you have signed up and logged into your TurkPrime account, you will need to connect your TurkPrime account to your MTurk account. If you do not have a Mechanical Turk account you can set one up here
TurkPrime needs your permission to access your MTurk account and to take control over your HITs. This includes being able to launch, stop, and make changes to your HITs. This is accomplished by associating your TurkPrime account with your MTurk account.
Associating your accounts is fast and easy.
Register with Amazon Mechanical Turk (MTurk) as a
Requester. This will allow you to create MTurk Human Intelligence Tasks (HITs).
TurkPrime allows you to create surveys (or other tasks) that will be completed by the multitudes of MTurk Workers around the world.
The MTurk Workers are paid for each completed task. See details here.
You must fund your own Amazon MTurk account in order to use TurkPrime with your account.
After completing MTurk registration, create an IAM (Identity and Access Management) user to access the MTurk API.
Go to https://console.aws.amazon.com/iam/home#/users and sign in
using the same username and password as you used for MTurk
- Choose Add user
- By User name, fill out a username. Select Add another user to add multiple users.
- By Access type, select Programmatic access
Select Next: Permissions
Set up MTurk permissions for IAM user (More at
Overview of IAM Policies)
- Select Attach existing policies directly
Check off AmazonMechanicalTurkFullAccess. (You can use the search bar to find it)
- Select Next: Review
- On this page, review your information, and select Create user
On this page, save your credentials:
- Choose Download .csv
Your browser automatically downloads the private key file (credentials.csv). Save the private key file in a safe place.
Important : This is the only chance for you to save the private key file. You will need these credentials to use the Amazon Mechanical Turk API.
- Choose Show to view your Secret Access Key.
- Copy the values for your Access Key ID and Secret Access Key into the form on the bottom of this page.
Please Note: Mechanical Turk may be used in either LIVE
LIVE mode will run your surveys and cost actual money. This is the option to use
when running REAL (LIVE) surveys.
SANDBOX mode may be used to test creating HITs. Your HITS will not be answered by workers. Your HITs are viewable on the MTurk site at
Sandbox mode sets your account balance to a fixed $10,000.
For your security, once entered, the Secret Access Key will not be visible to you. Store the credentials.csv file (which contains your secret keys)
that you previously downloaded in a safe place.