// fusionrest agent · hcm

HCM Contacts

hcmContacts Based on latest (2026.09)

Create, change and look up HCM Contacts, with addresses, citizenships and contact relationships.

The record key hcmContactsUniqID is a generated hash. Take it from the record's links (rel self) in a GET response; never build it yourself.

Oracle documents an Effective-Of header and an effectiveDate parameter for this resource, used for date-effective reads and changes.

/hcmRestApi/resources/11.13.18.05/hcmContacts
Operations
GET (list)GET (one)POST (create)PATCH (update)
Record key
hcmContactsUniqID
Required on create
none marked
At a glance
16 fields2 finders33 children
Extra parameters
?effectiveDate=Effective-Of:
I want to…List the latest 25Count recordsGet one recordCreate oneUpdate one

Try it

Response fields ·
Filters (q)

Only attributes Oracle marks as searchable are offered.

Finder
Include children (expand)
Paging and options
limit
Endpoint and headers
GET /hcmRestApi/resources/11.13.18.05/hcmContacts?fields=BloodType,BloodTypeMeaning,CorrLanguageMeaning,CorrespondenceLanguage,CountryOfBirth&limit=25&onlyData=true
Response shape (placeholders)
{
  "items": [
    {
      "BloodType": "<string, max 30>",
      "BloodTypeMeaning": "<string, max 80>",
      "CorrLanguageMeaning": "<string, max 80>",
      "CorrespondenceLanguage": "<string, max 30>",
      "CountryOfBirth": "<string, max 240>"
    }
  ],
  "count": 25,
  "hasMore": true,
  "limit": 25,
  "offset": 0
}

Shapes and placeholders, not real data. Replace https://<your-pod> and the login with your own: this site never sees them. Based on Oracle's latest (2026.09) REST specification.

Fields 16

AttributeTypeUse
BloodTypetext · max 30Optional on createUpdatable
BloodTypeMeaningtext · max 80Read-onlySearchable
CorrLanguageMeaningtext · max 80Read-onlySearchable
CorrespondenceLanguagetext · max 30Optional on createUpdatable
CountryOfBirthtext · max 240Optional on createUpdatable
CountryOfBirthNametext · max 80Read-onlySearchable
CreatedBytext · max 64Read-only
CreationDatedate-timeRead-only
DateOfBirthdateOptional on createUpdatableSearchable
DateOfDeathdateOptional on createUpdatable
LastUpdateDatedate-timeRead-only
LastUpdatedBytext · max 64Read-only
PersonIdnumberOptional on createSearchable
PersonNumbertext · max 30Optional on createUpdatableSearchable
RegionOfBirthtext · max 240Optional on createUpdatable
TownOfBirthtext · max 240Optional on createUpdatable

Names, types, labels and flags from Oracle's REST specification (latest (2026.09)). Flexfield and custom attributes vary by pod: check /describe for yours.

Finders 2

Predefined searches: ?finder=Name;variable=value,variable2=value2. Pick one in Try it to build the call.

Check a payload

Checked in your browser only; nothing you paste is sent anywhere. Checks names and flags, not values.

Children 33

Child resources sit under one record: /hcmRestApi/resources/11.13.18.05/hcmContacts/{hcmContactsUniqID}/child/<name>. Add them to a GET with expand.

Use in AI Agent Studio

More in For Builders.

Pitfalls