TrackerRMS Help

Your one-stop shop for help on TrackerRMS

Back to Topics

Help Topic: createResource


createResource

POST

/api/widget/createResource

Able to payload of data to the api in order to create or update a resource (candidate) record within the TrackerRMS database.

Please use only 1 of the following authentication methods

  • oAuth Header Authorization (preferred)
  • oAuth Token in the “credentials” section
  • Username and Password in the “credentials” section
  • ApiKey in the “credentials” section (user will default to system admin)

Sample Request:

{
      "trackerrms": {
             "createResource": {
                    "credentials": {
                          "username": "my.name@domain.com",
                          "password": "Welcome123",
                          "oauthtoken": "1bc7ca1e-8b9a-11e9-bc42-526af7764f64",
                          "apikey": "knREmvtzyRfBMfep2mvn"
                    },
                    "instructions": {
                          "overwriteresource": false,
                          "assigntoopportunity": 1654,
                          "assigntolist": “short”,
                          "shortlistedby": “resource”
                    },
                    "resource": {
                          "firstname": "Jane",
                          "lastname": "Selby",
                          "fullname": "Jane Selby",
                          "jobtitle": "Java Programmer",
                          "company": "Wonderful Java Inc",
                          "address1": "2245 Jasper Lane",
                          "address2": "Del Mar",
                          "city": "San Diego",
                          "state": "CA",
                          "zipcode": "92367",
                          "country": "United States",
                          "workphone": "",
                          "homephone": "555-3748",
                          "cellphone": "888-3487",
                          "email": "jane.selby@gmailx.com",
                          "linkedin": "https://linkedin.com/jsca/",
                          "dateofbirth": "1984-04-28",
                          "nationality": "United States",
                          "languages": "French, English",
                          "education": "Master’s Degree",
                          "source": "Website",
                          "jobhistory": [
                                 {
                                 "company": "Wonderful Java Inc.",
                                 "jobtitle": "Java Programmer",
                                 "startdate": "2016",
                                 "enddate": "",
                                 "description": "I programmed Java"
                                 },
                                 {
                                 "company": "Another Company",
                                 "jobtitle": "Junior JS Developer",
                                 "startdate": "2013",
                                 "enddate": "2017",
                                 "description": "Graduate developer"
                                 }
                          ],
                          "salary": 33000,
                          "note": "Lorem ipsum dolor sit amet.",
                          "image": "http://url.to.image",
                          "skills": "123,456,789,654",
                          "status": "Active",
                          "customfields": [
                                 {
                                 "id": 123,
                                 "value": "Value 1"
                                 },
                                 {
                                 "id": 456,
                                 "value": "Value 2"
                                 }
                          ]
                    }
             }
      }
}

Sample Response:
{
   "status": 0,
   "message": "success",
   "count": 0
}

Response status codes:

0

success (message will be “created” or “updated”)

1

user not found

2

user not active

3

record found and cannot be overwritten

99

Invalid request

 

Assign to List options:

short

Assign to the Shortlist

long

Assign to the Longlist

 

Shortlisted by options:

user

Set the status based on being shortlisted by a User

resource

Set the status based on being shortlisted by a Candidate

 

Skills options:

skillid

This is the unique skill id in Tracker and should relate to Quick Skills (type = YesNo) only

 

Custom Fields options:

id

This is the unique custom field id in Tracker which relates to resources

value

This is the string value the custom field is to be set to

 

Status options:

Please provide the Candidate Status name as it appears in the Candidate Status list e.g. Active, Registered, Working for Us etc.