Skip to content

Insert approver

Request

Security
OAuth2(Required scopes: enrichment.write)
Bodyapplication/jsonrequired
externalIdstring^\S+$required

External id of the approver that is globally unique across the provided approver data

Example:"UserID#1234"
externalClientIdstring

Identifier of the client entity in the source system which can be used to separate data

Example:"EXTERNAL_CLIENT_ID"
codestring

Code of the approver in the source system (not unique across clients)

Example:"CODE1"
companyAssignmentArray of strings

List of externalCompanyIds that the approver is assigned to

Example:
[
  "DE01",
  "US01"
]
isActiveboolean
Example:true
firstNamestring

First name of the approving person

Example:"Koala"
lastNamestring

Last name of the approving person

Example:"Hinze"
emailstring, (email)

Email address of the approving person

Example:"accountant@sap.com"
phoneNumberstring

Phone number of the approving person

Example:"+491001234567891"
customFieldsobject(customFields)

List of key value pairs containing custom fields from the source system

customMetadataobject(JsonObject)

Any nested structure with metadata that source system needs to send

Example:
{
  "someTopLevelProperty": "value1",
  "someNestedProperty": {
    "nestedProperty": "value2"
  },
  "someArrayProperty": [
    "value3",
    "value4"
  ]
}
curl -i -X POST \
  https://api.cloud.hypatos.ai/v2/enrichment/approvers \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "externalId": "UserID#1234",
    "externalClientId": "EXTERNAL_CLIENT_ID",
    "code": "CODE1",
    "companyAssignment": [
      "DE01",
      "US01"
    ],
    "isActive": true,
    "firstName": "Koala",
    "lastName": "Hinze",
    "email": "accountant@sap.com",
    "phoneNumber": "+491001234567891",
    "customFields": {
      "property1": "string",
      "property2": "string"
    },
    "customMetadata": {
      "someTopLevelProperty": "value1",
      "someNestedProperty": {
        "nestedProperty": "value2"
      },
      "someArrayProperty": [
        "value3",
        "value4"
      ]
    }
  }'

Responses

Successfully inserted

Bodyapplication/json
idstringrequired
Example:"3a429dc8-56d4-42ef-a4cf-2ebc9ad1ef38"
Response
{
  "id": "3a429dc8-56d4-42ef-a4cf-2ebc9ad1ef38"
}