Skip to main content
POST
/
auto-bidding
/
jobs
/
create
Create auto bidding job
curl --request POST \
  --url https://api.vollna.com/v1/auto-bidding/jobs/create \
  --header 'Content-Type: application/json' \
  --header 'X-API-TOKEN: <api-key>' \
  --data '
{
  "setup_id": 123,
  "upwork_job_id": "<string>",
  "project_id": 123,
  "scheduled_at": "2023-11-07T05:31:56Z",
  "scheduled_in": 15,
  "cover_letter": "<string>",
  "answers": [
    {
      "question": "<string>",
      "answer": "<string>"
    }
  ],
  "bid_amount": 123,
  "boost_bid_amount": 123
}
'
{
  "success": true,
  "message": "<string>",
  "job": {
    "id": 123,
    "upwork_job_id": "<string>",
    "status": "<string>",
    "scheduled_at": "<string>",
    "setup_id": 123,
    "setup_name": "<string>",
    "project_id": 123,
    "cover_letter_length": 123,
    "answers_count": 123,
    "bid_amount": "<string>"
  }
}

Authorizations

​
X-API-TOKEN
string
header
required

API token for authentication

Body

application/json
​
setup_id
integer
required

The ID of the auto bidding setup to use

​
upwork_job_id
string
required

The Upwork job ID (usually starts with ~)

​
project_id
integer

Vollna project ID. If not provided, system will search by upwork_job_id

​
scheduled_at
string<date-time>

ISO 8601 datetime string for when to schedule the job

​
scheduled_in
integer
default:15

Minutes from now to schedule the job (15-60 range). Alternative to scheduled_at

Required range: 15 <= x <= 60
​
cover_letter
string

Custom cover letter text. If not provided, uses setup's template

​
answers
object[]

Array of question/answer pairs for job application questions

​
bid_amount
number<float>

Bid amount for the job (hourly or fixed price)

​
boost_bid_amount
integer

Number of connects to boost the bid with

Response

Job created successfully

​
success
boolean
​
message
string
​
job
object