Create Contact

Create a new contact.

External Documentation

To learn more, visit the Oracle Service Cloud documentation.

Basic Parameters

Parameter	Description
Address City	The city of the contact’s address.
Address Country Lookup Name	The lookup name of the state or province of the contact’s address. Note: To fill country details use State Or Province ID or State Or Province Lookup Name.
Address Country Lookup Name	The lookup name of the country of the contact’s address. Note: To fill country details use Country ID or Country Lookup Name.
Address Postal Code	The postal code of the contact’s address.
Address Street	The street of the contact’s address.
Application Context	The application context information to attach as OSvC-CREST-Application-Context request header. For more information, please refer to Oracle documentation.
Country ID	The ID of the country of the contact’s address. Note: To fill country details use Country ID or Country Lookup Name.
Fill Address Information	Select to fill address information.
First Name	The first name of the contact.
Last Name	The last name of the contact.
Login Name	The login username for authentication.
Lookup Name	The lookup name of the contact.
Password	The password to set for the contact.
State Or Province ID	The ID of the state or province of the contact’s address. Note: To fill country details use State Or Province ID or State Or Province Lookup Name.
Title	The title for the new contact.

Advanced Parameters

Parameter	Description
Additional Parameters	A JSON object for additional body parameters. Values specified in this parameter will override equivalent parameters. For example: { “first_key”: 12345, “second_key”: “some_value” } The object must follow the vendor’s structure as defined in the API documentation.
Next Request After	The time (in milliseconds) that must elapse before subsequent API calls will be executed. This value will be attached as osvc-crest-next-request-after request header. For more information, please refer to Oracle documentation.

Example Output

{
  "id": 83,
  "lookupName": "Jonathan Randall",
  "createdTime": "2016-01-28T19:10:10.000Z",
  "updatedTime": "2016-01-28T19:10:10.000Z",
  "address": {
    "city": null,
    "country": null,
    "postalCode": null,
    "stateOrProvince": null,
    "street": null
  },
  "banner": {
    "importanceFlag": null,
    "text": null,
    "updatedByAccount": null,
    "updatedTime": null
  },
  "channelUsernames": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/channelUsernames"
      }
    ]
  },
  "contactType": null,
  "cRMModules": {
    "marketing": true,
    "sales": true,
    "service": true
  },
  "customFields": {
    "c": {
      "current_cust": null,
      "age": null,
      "wireless_provider": {
        "id": 1,
        "lookupName": "Technicomm"
      }
    }
  },
  "disabled": false,
  "emails": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/emails"
      }
    ]
  },
  "externalReference": null,
  "fileAttachments": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/fileAttachments"
      }
    ]
  },
  "login": null,
  "marketingSettings": {
    "contactLists": {
      "links": [
        {
          "rel": "self",
          "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/
           marketingSettings/contactLists"
        }
      ]
    },
    "emailFormat": null,
    "marketingOptIn": null,
    "marketingOrganizationName": null,
    "marketingOrganizationNameAlt": null,
    "surveyOptIn": null
  },
  "name": {
    "first": "Jonathan",
    "last": "Randall"
  },
  "nameFurigana": {
    "first": null,
    "last": null
  },
  "notes": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/notes"
      }
    ]
  },
  "openIDAccounts": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/openIDAccounts"
      }
    ]
  },
  "organization": null,
  "passwordEmailExpirationTime": null,
  "passwordExpirationTime": null,
  "phones": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/phones"
      }
    ]
  },
  "salesSettings": {
    "acquiredDate": null,
    "salesAccount": null
  },
  "serviceSettings": {
    "answerNotifications": {
      "links": [
        {
          "rel": "self",
          "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/
           serviceSettings/answerNotifications"
        }
      ]
    },
    "categoryNotifications": {
      "links": [
        {
          "rel": "self",
          "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/
           serviceSettings/categoryNotifications"
        }
      ]
    },
    "productNotifications": {
      "links": [
        {
          "rel": "self",
          "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/
           serviceSettings/productNotifications"
        }
      ]
    },
    "sLAInstances": {
      "links": [
        {
          "rel": "self",
          "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83/
           serviceSettings/sLAInstances"
        }
      ]
    }
  },
  "source": {
    "id": 6016,
    "lookupName": "Connect Web Services - REST",
    "parents": [
      {
        "id": 32007,
        "lookupName": "Public API"
      }
    ]
  },
  "title": null,
  "links": [
    {
      "rel": "self",
      "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83"
    },
    {
      "rel": "canonical",
      "href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/83"
    },
    {
      "rel": "describedby",
      "href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/contacts",
      "mediaType": "application/schema+json"
    }
  ]
}