How to Get Your Upwork API Access Key

UpJobPilot connects to Upwork using your own API credentials, so your tokens never leave your machine. Follow this guide to apply — approval usually takes 1-3 business days.

1 Open the Upwork Developer Portal

Go to the Upwork Developer Portal and click Create New Key:

https://www.upwork.com/developer/keys/apply →

You'll need to be logged into your Upwork account.

2 Fill in the Form Fields

3 Project Description

Copy and paste this description exactly (replace the email with your own):

⚠ Remember to replace your@email.com with your actual email address.

4 Callback URL

Enter this exact URL:

5 Permissions (Scopes)

Check the following permission scopes. Some are required for the app to function, others enable auto-import features:

• Activity Entities — Read-Only Access
• Common Entities — Read-Only Access
• Job Postings — Read-Only Access
• Read marketplace Job Postings
• Read public marketplace Job Postings
• View UserDetails
• Freelancer Profile — Read And Write Access for profile auto-import
• Talent Profile — Read And Write Access for skills auto-import

These scopes are marked as read/write by Upwork, but UpJobPilot only ever reads your data — never modifies it. Write access is part of the permission label on Upwork's side but the app has no code paths that write to your profile.

6 Submit the Request

Check the box "I agree to comply with the Upwork API Terms of Use" and click Submit.

7 Wait for Approval

Upwork reviews API requests manually. You'll receive an email when your request is approved — this usually takes a few hours to a few days.

Once approved, you'll find your Key and Secret in the Upwork Developer Portal. Keep these handy — you'll enter them into UpJobPilot's setup wizard after installation.