Quickstart

This guide walks through your first auto-apply request end-to-end. You'll need an active UpHunt account with at least one auto-apply credit.

Grab your API key

Head to Auto-Apply → API & Webhooks in the Dashboard and click Generate API Key. Copy the key — you'll only see it once.

Submit a proposal

Replace YOUR_API_KEY and run:

cURL

curl -X POST https://uphunt.io/api/auto-apply-v2/apply -H "Content-Type: application/json" -H "x-api-key: YOUR_API_KEY" -d '{"jobId":"~01abc123def456","coverLetter":"Hi, I would love to help with this project...","proposal":{"hourlyRate":65,"timeline":"1 to 3 months"},"profileId":"YOUR_PROFILE_ID"}'

Response:

200 OK

{
  "success": true,
  "queueId": "queue_abc123",
  "creditsRemaining": 42,
  "message": "Job queued for auto-apply. Credits will be deducted upon successful application."
}

Poll the status

Use the returned queueId to check the application state:

curl "https://uphunt.io/api/auto-apply-v2/status?queueId=queue_abc123" -H "x-api-key: YOUR_API_KEY"

See Check Status for the full state machine.

New in v2: You can now apply to any Upwork job by passing a full URL or ciphertext. No need to set up job feeds or listeners first.

Next steps

Full endpoint reference

Every parameter, every response shape.

Let AI write the proposal

Use /generate-proposal to create a cover letter automatically.

Automate via webhooks

Apply on every high-scoring matched job.

Copy-paste recipes

Common workflows ready to adapt.