Create a contact point

post

/crmRestApi/resources/11.13.18.05/partnerContacts/{PartyNumber}/child/contactPoints

Request

Path Parameters
  • The unique identifier for the partner contact party. It Can be system-generated or user-provided during create, based on the profile option HZ_GENERATE_PARTY_NUMBER.
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
  • Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Conflict ID
    Default Value: 0
    The unique identifier of the conflict. Note: This is an internal attribute and should not be used.
  • Title: Type
    Maximum Length: 30
    The type of the contact point such as EMAIL or PHONE.
  • Title: Created by Application
    Default Value: HZ_WS
    The module that created the contact point record.
  • Title: OK to Contact
    Indicates whether to use a particular contact method. Defaulted to false.
  • Title: Do Not Contact
    Indicates whether the contact point is not preferred for contact.
  • Title: Do Not Contact Reason
    Indicates the reason for "Do Not Contact" preference.
  • Title: Email
    Maximum Length: 255
    The e-mail address in the contact point.
  • Title: Email Purpose
    Maximum Length: 30
    The e-mail purpose for the email address in the contact point. For example: "BUSINESS" determines the purpose of the e-mail address.
  • Title: Object Version Number
    The object version number. (This is an internal attribute and should not be used)
  • Title: Party ID
    The unique identifier of the party of the partner company.
  • Title: Registry ID
    The party number of the partner company.
  • Title: Party Source System
    The name of the external source system.
  • Title: Party Source System Reference Value
    The identifier of the record from external source system.
  • Title: Area Code
    Maximum Length: 255
    The area code of the phone number in the contact point.
  • Title: Phone Country Code
    Maximum Length: 255
    The phone country code of the phone number in the contact point.
  • Title: Extension
    Maximum Length: 255
    The phone extension of the phone number in the contact point.
  • Title: Phone
    Maximum Length: 255
    The phone number in the contact point.
  • Title: Phone Purpose
    Maximum Length: 30
    The purpose of using the PHONE contact point. The accepted values are defined in the lookup type CONTACT_POINT_PURPOSE.Sample values: ASSISTANT,PERSONAL,HOME_BUSINESS,BUSINESS etc.
  • Title: Type
    The type of the phone number in the contact point. For example: "FAX" or "WORK" determines the type of the phone number.
  • Title: Preference Requested By
    The list of values indicating the preference requested.
  • Title: Primary
    Maximum Length: 1
    Default Value: false
    Indicates whether the contact point is primary.
  • Title: Phone
    Maximum Length: 255
    The raw phone number in the contact point.
  • Title: User ID
    The social network identifier. Note: This is an internal attribute and should not be used.
  • Title: Social Network
    The social network name. Note: This is an internal attribute and should not be used.
  • Title: Social Network Purpose
    Maximum Length: 30
    Defines the purpose of using the IM contact point. The accepted values are defined in the lookup type CONTACT_POINT_PURPOSE.Sample values: ASSISTANT, PERSONAL, HOME_BUSINESS, BUSINESS, and so on.
  • Title: Source System
    The name of the external source system.
  • Title: Source System Reference Value
    The identifier of the record from external source system.
  • Title: Status
    Maximum Length: 30
    Default Value: A
    The status of the contact point.
  • Title: URL
    The URL in the contact point.
  • Title: Verification Date
    The date of verification of the phone or email contact point.
  • Title: Verification Status
    Maximum Length: 30
    The list of values indicating the purpose of the social network.
  • Title: Web Purpose
    Maximum Length: 30
    The purpose of using the WEB contact point. The accepted values are defined in the lookup type CONTACT_POINT_PURPOSE_WEB.Sample values: HOMEPAGE, SALESURL, MARKETINGURL, SUPPORTURL, RSS_FEED and so on.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : partnerContacts-contactPoints-item-response
Type: object
Show Source
Back to Top