Hiring

Managing openings as part of the hiring process can involve several different APIs, this page outlines and links to the specific API calls involved. While it is not yet possible to directly hire via the APIs its important to understand how these APIs behave in terms of the hiring process.

The organization APIs are helpful in navigating the reference IDs of a user's company and teams, based on their permissions. Its important to fully understand how organization structure works on oDesk before hiring. Read about the organization APIs here.

It also important to understand what access a user has to the teams and companies they are members of, in order to know what these permissions are you will need to use the userroles API, read about it here.

The Jobs API

In order to reference a job you first need to know the Job reference ID. The jobs API can list jobs by team or company and also provides details regarding a specific job. Read more about the jobs API here.

Offers API

Hiring a provider for a job requires that you have open offers on the specific job. The offers API returns a complete list of offers on a specific job. This requires that you know the job id (reference) for the job you are looking for offers on. Once you know the job id you can list all the offers (or sort offers based on the API parameters). Read about the offers API here.

Engagements API ("Assignments API")

After a provider has been hired to a job, an engagement (sometimes called an assignment on oDesk.com) begins. The engagements API will return active and inactive engagements for teams or an engagement. Read about the engagement API here.