Create additional contact

Use case

Here we will cover how to add additional contacts to a legal person that can be used to reach out to different departments like accounting, fraud, risk etc. We will add fraud department contacts to New company Ltd.

Use case data	API parameters with values
The personId of the legal person New company Ltd is ID-3394.	...persons/ID-3394/additional-contact
The contact type code is the fraud department.	"contactTypeCode": "FRAUD_CONTACT"
The description of the contact type.	"description": "Contacts for fraud department"
The email of the contact.	"email": "[e-mail]"
The phone number of the contact.	"phoneNumber": "0901820"
The country code of the phone number.	"phoneCountryCode": "+49"

Sample API call

To add additional contact to the person, make the following API call.

https://person-api.sandbox.tuumplatform.com/api/v2/persons/ID-3394/additional-contacts

See more information about creating person additional contacts endpoint in the Tuum developer portal.

Sample request

Below is an example request body of the API call for creating additional contacts.

JSON

{
 "contactTypeCode": "FRAUD_CONTACT",
  "description": "Contacts for fraud department",
  "email": "[e-mail]",
  "phoneNumber": "0901820",
  "phoneCountryCode": "+49"
}

cURL

curl --location 'https://person-api.sandbox.tuumplatform.com/api/v2/persons/ID-3394/additional-contacts' \
--header 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHBpcnlEVGltZSI6IjIwMjQtMDUtMjFUMDc6MjY6NTMiLCJyb2xlcyI6WyJBRE1JTiJdLCJuYW1lIjoiSm9obiBPZmZpY2VyIiwiZW1wbG95ZWVJZCI6IjEiLCJ0ZW5hbnRDb2RlIjoiTUIiLCJleHAiOjE3MTYyNzY0MTN9.sQw8rjIaygzdHjCKDSlEQsHu0Lvh3U0EjAWWEYaAH5A' \
--header 'x-channel-code: SYSTEM' \
--header 'Content-Type: application/json' \
--data-raw '{
 "contactTypeCode": "FRAUD_CONTACT",
  "description": "Contacts for fraud department",
  "email": "[e-mail]",
  "phoneNumber": "0901820",
  "phoneCountryCode": "+49"
}'

Sample response

Here you find an example response body to the API call above.

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "additionalContactId": "ID-1009",
        "personId": "ID-3394",
        "contactTypeCode": "FRAUD_CONTACT",
        "description": "Contacts for fraud department",
        "email": "[e-mail]",
        "phoneCountryCode": "+49",
        "phoneNumber": "0901820",
        "preferredMethodOfContact": false,
        "validityRange": {
            "endTime": null,
            "startTime": "2024-05-21T06:46:42.928Z"
        }
    }
}

Result

A new fraud department contact is added to the person.