Resources

Inserts or updates resource details as a contact or person account record.

Request Keys

The following keys are available to use for the worker to resource integration.

CorrelationId - The resource's unique identifier that links them to a third-party HCM application.
LastName - The resource's last name.
Salutation - The resource's salutation that indicates their profession or marital status.
FirstName - The resource's first name.
Street - The street details of the resource's address.
City - The city details of the resource's address.
StateOrProvince - The state or province details of the resource's address.
PostalCode - The postal code or ZIP code of the resource's address.
Country - The country details of the resource's address.
Phone - The resource's phone number.
MobilePhone - The resource's mobile phone number.
Email - The resource's email address.
BusinessTitle - The resource's business title.
ReportsTo - The resource's manager. This key is only available when creating resources as contacts.
ExternalResource - Indicates that the resource is external to the organization, such as a contractor.
CostCenter - The resource's cost center in the organization structure.
Department - The resource's department in the organization structure.
Division - The resource's division in the organization structure.
Location - The resource's location in the organization structure.
ResourceStatus - The resource's employment status.
ResourceStatusEffectiveDate - The date the resource's employment status becomes effective.
ResourceRole - The resource's role.
WorkCalendar - The resource's work calendar.
CustomField1 - Additional information.
CustomField2 - Additional information.
CustomField3 - Additional information.
CustomField4 - Additional information.
CustomField5 - Additional information.
CustomField6 - Additional information.
CustomField7 - Additional information.
CustomField8 - Additional information.
CustomField9 - Additional information.
CustomField10 - Additional information.
CustomField11 - Additional information.
CustomField12 - Additional information.
CustomField13 - Additional information.
CustomField14 - Additional information.
CustomField15 - Additional information.

You must use the date format YYYY-MM-DD, such as 2018-04-24.

Response Keys

The following keys are used in the response.

CorrelationId - The resource's unique identifier that links them to a third-party HCM application.
Message - The message returned when an error occurs in a processing request.

POST

URI	/services/apexrest/pse/v1.0/resources/*
Description	Inserts resource details as a contact or person account record.

Sample Code


//POST Request 1
[{
   "CorrelationId": "93847jdue7",
   "LastName": "Smith",
   "Salutation": "Mr",
   "FirstName": "John",
   "Street": "123 Test St",
   "City": "Philadelphia",
   "StateOrProvince": "PA",
   "PostalCode": "12345",
   "Country": "USA",
   "Phone": "847-321-4326",
   "MobilePhone": "555-805-4326",
   "Email": "test@test.com",
   "BusinessTitle": "Marketing Consultant",
   "ReportsTo": "93847jdue2",
   "ExternalResource": false,
   "Division": "Sales",
   "CostCenter": "11223344",
   "Department": "Mid Market Sales",
   "Location": "Philadelphia",
   "ResourceStatus": "A",
   "ResourceStatusEffectiveDate": "1991-11-20",
   "ResourceRole": "Architect",
   "WorkCalendar": "US Default",
   "CustomField1": "test",
   "CustomField2": "test2",
   "CustomField3": "test3",
   "CustomField4": "test4",
   "CustomField5": "test5",
   "CustomField6": "test6",
   "CustomField7": "test7",
   "CustomField8": "test8",
   "CustomField9": "test9",
   "CustomField10": "test10",
   "CustomField11": "test11",
   "CustomField12": "test12",
   "CustomField13": "test13",
   "CustomField14": "test14",
   "CustomField15": "test15"
},
{
   "CorrelationId": "93847jdue0",
   "LastName": "Smith",
   "Salutation": "Mr",
   "FirstName": "Jonathan",
   "Street": "123 Test St",
   "City": "Philadelphia",
   "StateOrProvince": "PA",
   "PostalCode": "12645",
   "Country": "USA",
   "Phone": "847-325-4326",
   "MobilePhone": "555-815-4326",
   "Email": "test2@test.com",
   "BusinessTitle": "Marketing Consultant",
   "ReportsTo": "93847jdue2",
   "ExternalResource": false,
   "Division": "Sales",
   "CostCenter": "11223344",
   "Department": "Mid Market Sales",
   "Location": "Philadelphia",
   "ResourceStatus": "A",
   "ResourceStatusEffectiveDate": "1991-11-20",
   "ResourceRole": "Architect",
   "WorkCalendar": "US Default",
   "CustomField1": "test",
   "CustomField2": "test2",
   "CustomField3": "test3",
   "CustomField4": "test4",
   "CustomField5": "test5",
   "CustomField6": "test6",
   "CustomField7": "test7",
   "CustomField8": "test8",
   "CustomField9": "test9",
   "CustomField10": "test10",
   "CustomField11": "test11",
   "CustomField12": "test12",
   "CustomField13": "test13",
   "CustomField14": "test14",
   "CustomField15": "test15"
}
]

//POST Response 1
HTTP/1.1 200 OK


//POST Request 2
[{
   "CorrelationId": "93847jdue7",
   "LastName": "Smith",
   "ABCkey": "1234"
}]

//POST Response 2
HTTP/1.1 400 Bad Request

[{
    "CorrelationId": "93847jdue7",
    "Message": "The following keys are invalid: ABCkey. Contact your administrator."
}]

PATCH

URI	/services/apexrest/pse/v1.0/resources/*
Description	Inserts or updates resource details as a contact or person account record.

Sample Code


//PATCH Request 1
[{
   "CorrelationId": "93847jdue7",
   "LastName": "Smith",
   "Salutation": "Mr",
   "FirstName": "John",
   "Street": "123 Test St",
   "City": "Philadelphia",
   "StateOrProvince": "PA",
   "PostalCode": "12345",
   "Country": "USA",
   "Phone": "847-321-4326",
   "MobilePhone": "555-805-4326",
   "Email": "test@test.com",
   "BusinessTitle": "Marketing Consultant",
   "ReportsTo": "93847jdue3",
   "ExternalResource": false,
   "Division": "Sales",
   "CostCenter": "11223344",
   "Department": "Mid Market Sales",
   "Location": "Philadelphia",
   "ResourceStatus": "A",
   "ResourceStatusEffectiveDate": "1991-11-20",
   "ResourceRole": "Architect",
   "WorkCalendar": "US Default",
   "CustomField1": "test",
   "CustomField2": "test2",
   "CustomField3": "test3",
   "CustomField4": "test4",
   "CustomField5": "test5",
   "CustomField6": "test6",
   "CustomField7": "test7",
   "CustomField8": "test8",
   "CustomField9": "test9",
   "CustomField10": "test10",
   "CustomField11": "test11",
   "CustomField12": "test12",
   "CustomField13": "test13",
   "CustomField14": "test14",
   "CustomField15": "test15" 
},
{
   "CorrelationId": "93847jdue0",
   "LastName": "Smith",
   "Salutation": "Mr",
   "FirstName": "Jonathan",
   "Street": "123 Test St",
   "City": "Philadelphia",
   "StateOrProvince": "PA",
   "PostalCode": "12645",
   "Country": "USA",
   "Phone": "847-325-4326",
   "MobilePhone": "555-815-4326",
   "Email": "test2@test.com",
   "BusinessTitle": "Marketing Consultant",
   "ReportsTo": "93847jdue6",
   "ExternalResource": false,
   "Division": "Sales",
   "CostCenter": "11223344",
   "Department": "Mid Market Sales",
   "Location": "Philadelphia",
   "ResourceStatus": "A",
   "ResourceStatusEffectiveDate": "1991-11-20",
   "ResourceRole": "Architect",
   "WorkCalendar": "US Default",
   "CustomField1": "test",
   "CustomField2": "test2",
   "CustomField3": "test3",
   "CustomField4": "test4",
   "CustomField5": "test5",
   "CustomField6": "test6",
   "CustomField7": "test7",
   "CustomField8": "test8",
   "CustomField9": "test9",
   "CustomField10": "test10",
   "CustomField11": "test11",
   "CustomField12": "test12",
   "CustomField13": "test13",
   "CustomField14": "test14",
   "CustomField15": "test15"
}
]

//PATCH Response 1
HTTP/1.1 200 OK


//PATCH Request 2
[{
   "CorrelationId": "93847jdue7",
   "LastName": "Smith",
   "ABCkey": "1234",
}]

//PATCH Response 2
HTTP/1.1 400 Bad Request

[{
    "CorrelationId": "93847jdue7",
    "Message": "The following keys are invalid: ABCkey. Contact your administrator."
}]