Create Contact Point
Overview
This section contains the required and optional elements for contact point. Multiple contact points can be created for a contact person.
Email contact point
Elements required in request body
| Name | Description |
| type.value | Must be "email". |
| type.email.emailAddress | Must be a valid email address. Refer Email Address definition for the valid email address format.
If "Customer departmentalization" setting is enabled in the application, the provided email address must not be associated with any existing contact points in the same department.
If "Customer departmentalization" setting is disabled in application, the provided email address must not be associated with any existing contact points in the application. |
Optional elements allowed in request body
| Name | Description |
| priority.value | Must be 'low', 'medium', or 'high'. |
| customAttributes | Name must match one of the custom attributes configured in application. If the custom attribute is configured as an enumeration, the value must be one of the predefined values.
For string type of custom attribute that is not configured as an enumeration, refer list of Allowed Characters For Custom Attributes. |
Phone contact point
Elements required in request body
| Name | Description |
| type.value | Must be "phone". |
| type.phone.type.value | This can be one of 'home', 'office', 'mobile', 'fax', or 'pager'. |
| type.phone.phoneNo | This accepts any string representation. It is the client's responsibility to send in the correct number. Must not exceed 40 characters. |
Optional elements allowed in request body
| Name | Description |
| type.phone.countryCode | Must be a number not exceeding 9 digits. |
| type.phone.areaCode | Must not exceed 10 characters. |
| type.phone.extension | Must not exceed 10 characters. |
| type.phone.availability.days.value | Must be one of weekdays, weekends, and 'any_day'. |
| type.phone.availability.times.value | Must be one of 'mornings', 'afternoons', 'evenings', 'day', and 'anytime'. |
| priority.value | Must be 'low', 'medium', or 'high'. |
| customAttributes | Name must match one of the custom attributes configured in application. If the custom attribute is configured as an enumeration, the value must be one of the predefined values.
For string type of custom attribute that is not configured as an enumeration, refer list of Allowed Characters For Custom Attributes. |
Postal contact point
Elements required in request body
| Name | Description |
| type.value | Must be "postal". |
| type.postal.type.value | Must be one of 'office', 'home', 'mailto', 'billto', or 'shipto'. |
| type.postal.address_1 | Must not exceed 50 characters. |
Optional elements allowed in request body
| Name | Description |
| type.postal.address_2 | Must not exceed 50 characters. |
| type.postal.city | Must not exceed 50 characters. |
| type.postal.state | Must not exceed 50 characters. |
| type.postal.zip | Must not exceed 50 characters. |
| type.postal.country | Must not exceed 50 characters. |
| type.postal.region | Must not exceed 50 characters. |
| priority.value | Must be 'low', 'medium', or 'high'. |
| customAttributes | Name must match one of the custom attributes configured in application. If the custom attribute is configured as an enumeration, the value must be one of the predefined values.
For string type of custom attribute that is not configured as an enumeration, refer list of Allowed Characters For Custom Attributes. |
Web contact point
Elements required in request body
| Name | Description |
| type.value | Must be "web". |
| type.website.url | Must not exceed 1024 characters. |
Optional elements allowed in request body
| Name | Description |
| priority.value | Must be 'low', 'medium', or 'high'. |
| customAttributes | Name must match one of the custom attributes configured in application. If the custom attribute is configured as an enumeration, the value must be one of the predefined values.
For string type of custom attribute that is not configured as an enumeration, refer list of Allowed Characters For Custom Attributes. |
Social contact point
Elements required in request body
| Name | Description |
| type.value | Must be "social". |
| type.social.type.value | Must be one of 'twitter, 'facebook', 'instagram', 'apple_opaque_id', 'community', or 'other'. |
| type.socialId | Must not exceed 255 characters. |
Optional elements allowed in request body
| Name | Description |
| priority.value | Must be 'low', 'medium', or 'high'. |
| customAttributes | Name must match one of the custom attributes configured in application. If the custom attribute is configured as an enumeration, the value must be one of the predefined values.
For string type of custom attribute that is not configured as an enumeration, refer list of Allowed Characters For Custom Attributes. |
