{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":497,"path":"api-reference/rest-apis/contact-api.md","title":"Contact API","bundle":null,"doc_type":null,"release":"australia","body":"\n# Contact API\n\nThe Contact API provides endpoints that enable you to retrieve and update Customer Service Management \\(CSM\\) contact records.\n\nIn addition, you can generate new social media profile records when creating a contact.\n\nThe Contact API requires the Customer Service plugin \\(com.sn\\_customerservice\\) and is provided within the `now` namespace.\n\nUsers need the csm\\_ws\\_integration role for full API access.\n\n**Parent Topic:**[REST API reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-apis/api-rest.md)\n\n## Contact - GET /now/contact\n\nRetrieves a specified set of Customer Service Management \\(CSM\\) contacts.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/contact`\n\nDefault URL: `/api/now/contact`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n\n
\n\nName\n\n\n\nDescription\n\n
\n\napi\\_version\n\n\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n
\n
\n\nName\n\n\n\nDescription\n\n
\n\nsysparm\\_limit\n\n\n\nMaximum number of records to return. For requests that exceed this number of records, use the **sysparm\\_offset** parameter to paginate record retrieval.\n\nIn the response, the boolean parameter **hasMore** is returned. It indicates whether there are more records to return that meet the filter criteria.\n\nData type: Number\n\nDefault: 10\n\n
\n\nsysparm\\_offset\n\n\n\nStarting record index for which to begin retrieving records. Use this value to paginate record retrieval. This functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks.\n\nFor example, the first time you call this endpoint, **sysparm\\_offset** is set to \"0\". To simply page through all available records, use `sysparm_offset=sysparm_offset+sysparm_limit`, until you reach the end of all records.\n\nDo not pass a negative number in the **sysparm\\_offset** parameter.\n\nData type: Number\n\nDefault: 0\n\n
\n\nsysparm\\_query\n\n\n\nEncoded query used to filter the result set.For example:\n\n`sysparm_query=caller_id=javascript:gs.getUserID()^active=true`\n\nThe encoded query supports order by. To sort responses based on certain fields, use the ORDERBY and ORDERBYDESC clauses in **sysparm\\_query**. For example, `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` filters all active records and orders the results in ascending order by number first, and then in descending order by category.\n\nIf part of the query is invalid, such as by specifying an invalid field name, the instance ignores the invalid part. It then returns rows using only the valid portion of the query. You can control this behavior using the property **glide.invalid\\_query.returns\\_no\\_rows**. Set this property to true to return no rows on an invalid query.\n\n**Note:** The **glide.invalid\\_query.returns\\_no\\_rows** property controls the behavior of all queries across the instance, such as in lists, scripts \\(GlideRecord.query\\(\\)\\), and web service APIs.\n\nData type: String\n\n
|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n\n
\n\nHeader\n\n\n\nDescription\n\n
\n\nAccept\n\n\n\nData format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**\n\n
|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|200|Successful. The request was successfully processed.|\n|500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|\n|500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|\n\n### Response body parameters \\(JSON or XML\\)\n\nThe endpoint may return the following JSON or XML elements in the response body. In addition to the list of elements defined below \\(which define the elements in a base system\\), the endpoint also returns any custom fields added to the Contact \\[customer\\_contact\\] table. For additional information on these elements, refer to your specific table definition \\[**System Definition** > **Tables**\\].\n\n\n
\n\nElement\n\n\n\nDescription\n\n
\n\naccount\n\n\n\nSys\\_id of the account record to which the contact is associated.Data type: String\n\nTable: Account \\[customer\\_account\\]\n\n
\n\nactive\n\n\n\nFlag that indicates whether the contact is active within the system.Possible values:\n\n- true: Contact is active\n- false: Contact is inactive\n\nData type: Boolean\n\nDefault: true\n\n
\n\nagent\\_status\n\n\n\nStatus of the agent.Possible values:\n\n- Off work\n- On break\n- On route\n- On site\n\nData type: String\n\nMaximum length: 40\n\n
\n\nbuilding\n\n\n\nSys\\_id of the record that describes the building in which the contact resides.Data type: String\n\nTable: Building \\[cmn\\_building\\]\n\n
\n\ncalendar\\_integration\n\n\n\nCalendar application that the contact uses.1: Outlook\n\nData type: Number \\(Integer\\)\n\nDefault: 1\n\n
\n\ncity\n\n\n\nCity in which the contact resides.Data type: String\n\nMaximum length: 40\n\n
\n\ncompany\n\n\n\nSys\\_id of the company record to which the contact is associated.Data type: String\n\nTable: Company \\[core\\_company\\]\n\n
\n\ncost\\_center\n\n\n\nSys\\_id of the cost center associated with the contact.Data type: String\n\nTable: Cost Center \\[cmn\\_cost\\_center\\]\n\n
\n\ncountry\n\n\n\nCountry code of the country in which the contact resides.Data type: String\n\nMaximum length: 3\n\n
\n\ndate\\_format\n\n\n\nFormat in which to display dates to contacts.Valid values:\n\n- dd/mm/yyyy\n- dd-mm-yyyy\n- dd.mm.yyyy\n- mm-dd-yyyy\n- yyyy-mm-dd\n\nData type: String\n\nMaximum length: 40\n\nDefault: blank \\(system date format\\)\n\n
\n\ndefault\\_perspective\n\n\n\nSys\\_id of the default perspective for the contact.Data type: String\n\nTable: Menu List \\[sys\\_perspective\\]\n\n
\n\ndepartment\n\n\n\nSys\\_id of the department associated with the contact.Data type: String\n\nTable: Department \\[cmn\\_department\\]\n\n
\n\nedu\\_status\n\n\n\nEducation status of the associated contact.Data type: String\n\nMaximum length: 40\n\nDefault: faculty\n\n
\n\nemail\n\n\n\nContact email address.Data type: String\n\n
\n\nemployee\\_number\n\n\n\nContact employee number.Data type: String\n\n
\n\nenable\\_multifactor\\_authn\n\n\n\nFlag that indicates whether multifactor authorization is required for the contact to log in to the service portal.Possible values:\n\n- true: Multifactor authorization enabled\n- false: Multifactor authorization disabled\n\nData type: Boolean\n\nDefault: false\n\n
\n\nfailed\\_attempts\n\n\n\nNumber of failed log in attempts.Data type: Number \\(Integer\\)\n\n
\n\nfirst\\_name\n\n\n\nContact first name.Data type: String\n\nMaximum length: 50\n\n
\n\ngender\n\n\n\nContact gender.Data type: String\n\nMaximum length: 40\n\n
\n\ngeolocation\\_tracked\n\n\n\nFlag that indicates whether the contact location is obtained through geotracking.Possible values:\n\n- true: Contact location obtained through geotracking\n- false: Contact location not obtained through geotracking\n\nData type: Boolean\n\nDefault value: false\n\n
\n\nhome\\_phone\n\n\n\nContact home phone number.Data type: String\n\nMaximum length: 40\n\n
\n\ninternal\\_integration\\_user\n\n\n\nFlag that indicates whether the contact is an internal integration user.Possible values:\n\n- true: Internal integration user\n- false: Other type of user\n\nData type: Boolean\n\nDefault: false\n\n
\n\nintroduction\n\n\n\nIntroductionData type: String\n\nMaximum length: 40\n\n
\n\nlast\\_login\n\n\n\nDate on which the contact last logged into the system.Data type: String \\(Date\\)\n\n
\n\nlast\\_login\\_device\n\n\n\nDevice the consumer used the last time they logged in to the system.Data type: String\n\nMaximum length: 40\n\n
\n\nlast\\_login\\_time\n\n\n\nDate and time the contact logged in to the system.Data type: String \\(Date/time\\)\n\n
\n\nlast\\_name\n\n\n\nContact last name.Data type: String\n\nMaximum length: 50\n\n
\n\nlast\\_position\\_update\n\n\n\nDate and time the last position was updated.Data type: String \\(Date/time\\)\n\n
\n\nlatitude\n\n\n\nLatitude coordinate of the contact.Data type: Number \\(Floating point\\)\n\nMaximum length: 40\n\n
\n\nldap\\_server\n\n\n\nSys\\_id of the LDAP server used by the contact to last log in to the system. Data type: String\n\nTable: LDAP Server \\[ldap\\_server\\_config\\]\n\n
\n\nlocation\n\n\n\nSys\\_id of the record that describes the location of the contactData type: String\n\nTable: Location \\[cmn\\_location\\]\n\n
\n\nlocked\\_out\n\n\n\nFlag that indicates if the contact is locked-out.Possible values:\n\n- true: Contact locked-out\n- false: Contact not locked-out\n\nData type: Boolean\n\nDefault: false\n\n
\n\nlongitude\n\n\n\nLongitude coordinate of the contact.Data type: Number \\(Floating point\\)\n\nMaximum length: 40\n\n
\n\nmanager\n\n\n\nSys\\_id of the record that describes the direct supervisor of the contact.Data type: String\n\nTable: User \\[sys\\_user\\]\n\n
\n\nmiddle\\_name\n\n\n\nContact middle name.Data type: Number \\(Floating point\\)\n\nMaximum length: 50\n\n
\n\nmobile\\_phone\n\n\n\nContact mobile phone number.Data type: String\n\n Maximum length: 40\n\n
\n\nname\n\n\n\nContact full name.Data type: String\n\nMaximum length: 151\n\n
\n\nnotification\n\n\n\nIndicates whether the contact should receive notifications.Valid values:\n\n- 1: Disabled\n- 2: Enabled\n\nData type: Number \\(Integer\\)\n\nDefault: 2\n\n
\n\non\\_schedule\n\n\n\nIndicates the timeliness of dispatched service personnel.Valid values:\n\n- Ahead: Ahead of schedule.\n- behind\\_less30: Behind schedule, but less than 30 minutes.\n- behind\\_30to60: Behind schedule between 30 and 60 minutes.\n- behind\\_more60: Behind schedule more than 60 minutes.\n- on\\_time: On schedule.\n\nData type: String\n\nMaximum length: 40\n\n
\n\nphone\n\n\n\nContact business phone number.Data type: String\n\nMaximum length: 40\n\n
\n\nphoto\n\n\n\nPhoto image of the contact. Data type: String\n\n
\n\npreferred\\_language\n\n\n\nCountry code of the contact primary language.Data type: String\n\nMaximum length: 3\n\n
\n\nroles\n\n\n\nList of user roles associated with the contact.Data type: String\n\nMaximum length: 40\n\n
\n\nschedule\n\n\n\nSys\\_id of the record that describes the work schedule for the associated contact.Data type: String\n\nTable: Schedule \\[cmn\\_schedule\\]\n\n
\n\nsource\n\n\n\nSource of the contact.Data type: String\n\nMaximum length: 255\n\n
\n\nstate\n\n\n\nState in which the contact resides.Data type: String\n\nMaximum length: 40\n\n
\n\nstreet\n\n\n\nContact street address.Data type: String\n\nMaximum length: 255\n\n
\n\nsys\\_class\\_name\n\n\n\nTable that contains the contact record. Data type: String\n\nMaximum length: 80\n\n
\n\nsys\\_created\\_by\n\n\n\nUser that originally created the associated contact record.Data type: String\n\nMaximum length: 40\n\n
\n\nsys\\_created\\_on\n\n\n\nData and time the associated contact was originally created.Data type: String \\(Date/time\\)\n\n
\n\nsys\\_domain\n\n\n\nServiceNow instance domain of the associated contact record.Data type: String\n\n
\n\nsys\\_domain\\_path\n\n\n\nContact record domain path.Data type: String\n\nMaximum length: 255\n\nDefault: / \\(global\\)\n\n
\n\nsys\\_id\n\n\n\nUnique identifier for the associated contact record.Data type: String\n\n
\n\nsys\\_mod\\_count\n\n\n\nNumber of times that the associated contact record has been modified.Data type: Number \\(Integer\\)\n\n
\n\nsys\\_tags\n\n\n\nSystem tags.Data type: String\n\n
\n\nsys\\_updated\\_by\n\n\n\nUser that last updated the associated contact information.Data type: String\n\nMaximum length: 40\n\n
\n\nsys\\_updated\\_on\n\n\n\nData and time the associated contact information was updated.Data type: String \\(Date/time\\)\n\n
\n\ntime\\_format\n\n\n\nFormat in which to display time.Valid values:\n\n- hh.mm.ss a: hh.mm.ss \\(12 hour\\)\n- hh:mm:ss a: hh:mm:ss \\(12 hour\\)\n- HH.mm.ss: hh.mm.ss \\(24 hour\\)\n- HH:mm:ss: hh:mm:ss \\(24 hour\\)\n\nData type: String\n\nMaximum length: 40\n\nDefault: Blank \\(system time format\\)\n\n
\n\ntime\\_sheet\\_policy\n\n\n\nSys\\_id of the record that contains the time sheet policy for the associated contact.Data type: String\n\nTable: Time Sheet Policy \\[time\\_sheet\\_policy\\]\n\n
\n\ntime\\_zone\n\n\n\nTime zone in which the contact resides, such as Canada/Central or US/Eastern.Data type: String\n\nMaximum length: 40\n\n
\n\ntitle\n\n\n\nContact business title such as Manager, Software Developer, or Contractor.Data type: String\n\nMaximum length: 60\n\n
\n\nuser\\_name\n\n\n\nContact user ID.Data type: String\n\nMaximum length: 40\n\n
\n\nvip\n\n\n\nFlag that indicates whether the associated contact has VIP status.Possible values:\n\n- true: VIP\n- false: Not VIP\n\nData type: Boolean\n\nDefault: false\n\n
\n\nweb\\_service\\_access\\_only\n\n\n\nFlag that indicates whether the contact can only access services through the web.Possible values:\n\n- true: Web access only\n- false: Access through all available methods\n\nData type: Boolean\n\nDefault: false\n\n
\n\nzip\n\n\n\nContact zip code.Data type: String\n\nMaximum length: 40\n\n
### cURL request\n\n```\ncurl \"https://instance.servicenow.com/api/now/contact?sysparm_query=account=86837a386f0331003b3c498f5d3ee4ca&sysparm_limit=2&sysparm_offset=2>;rel=\"next\" \\\n--request GET \\\n--header \"Accept:application/json\" \\\n--user \"username\":\"password\"\n\n```\n\n```\n{\n \"result\": [\n {\n \"country\": \"\",\n \"calendar_integration\": \"1\",\n \"last_position_update\": \"\",\n \"last_login_time\": \"2018-03-10 21:48:11\",\n \"last_login_device\": \"\",\n \"source\": \"\",\n \"sys_updated_on\": \"2019-01-03 05:49:34\",\n \"building\": \"\",\n \"web_service_access_only\": \"false\",\n \"notification\": \"2\",\n \"sys_updated_by\": \"system\",\n \"enable_multifactor_authn\": \"false\",\n \"sys_created_on\": \"2018-03-04 20:26:32\",\n \"sys_domain\": \"global\",\n \"agent_status\": \"\",\n \"state\": \"\",\n \"vip\": \"false\",\n \"sys_created_by\": \"admin\",\n \"longitude\": \"\",\n \"zip\": \"\",\n \"home_phone\": \"\",\n \"time_format\": \"\",\n \"last_login\": \"\",\n \"default_perspective\": \"\",\n \"geolocation_tracked\": \"false\",\n \"active\": \"true\",\n \"time_sheet_policy\": \"\",\n \"sys_domain_path\": \"/\",\n \"phone\": \"+1 858 287 7834\",\n \"cost_center\": \"\",\n \"name\": \"George Warren\",\n \"employee_number\": \"\",\n \"gender\": \"\",\n \"city\": \"\",\n \"user_name\": \"george.warren\",\n \"failed_attempts\": \"\",\n \"edu_status\": \"\",\n \"latitude\": \"\",\n \"roles\": \"\",\n \"title\": \"Network Administrator\",\n \"sys_class_name\": \"customer_contact\",\n \"sys_id\": \"ddce70866f9331003b3c498f5d3ee417\",\n \"internal_integration_user\": \"false\",\n \"ldap_server\": \"\",\n \"mobile_phone\": \"+1 858 867 7857\",\n \"street\": \"\",\n \"company\": \"86837a386f0331003b3c498f5d3ee4ca\",\n \"department\": \"\",\n \"first_name\": \"George\",\n \"preferred_language\": \"\",\n \"introduction\": \"\",\n \"email\": \"geo.warren@mailinator.com\",\n \"manager\": \"\",\n \"locked_out\": \"false\",\n \"sys_mod_count\": \"3\",\n \"last_name\": \"Warren\",\n \"photo\": \"\",\n \"sys_tags\": \"\",\n \"middle_name\": \"\",\n \"time_zone\": \"\",\n \"schedule\": \"\",\n \"on_schedule\": \"\",\n \"date_format\": \"\",\n \"location\": \"25ab8e460a0a0bb300857304ff811af5\",\n \"account\": \"86837a386f0331003b3c498f5d3ee4ca\"\n },\n {\n \"country\": \"\",\n \"calendar_integration\": \"1\",\n \"last_position_update\": \"\",\n \"last_login_time\": \"2019-01-03 15:08:57\",\n \"last_login_device\": \"73.71.157.241\",\n \"source\": \"\",\n \"sys_updated_on\": \"2019-01-03 23:26:12\",\n \"building\": \"\",\n \"web_service_access_only\": \"false\",\n \"notification\": \"2\",\n \"sys_updated_by\": \"admin\",\n \"enable_multifactor_authn\": \"false\",\n \"sys_created_on\": \"2019-01-03 15:07:25\",\n \"sys_domain\": \"global\",\n \"agent_status\": \"\",\n \"state\": \"\",\n \"vip\": \"false\",\n \"sys_created_by\": \"carl.customer\",\n \"longitude\": \"\",\n \"zip\": \"\",\n \"home_phone\": \"\",\n \"time_format\": \"\",\n \"last_login\": \"\",\n \"default_perspective\": \"\",\n \"geolocation_tracked\": \"false\",\n \"active\": \"true\",\n \"time_sheet_policy\": \"\",\n \"sys_domain_path\": \"/\",\n \"phone\": \"+16692627777\",\n \"cost_center\": \"\",\n \"name\": \"Jane Contact\",\n \"employee_number\": \"\",\n \"gender\": \"\",\n \"city\": \"\",\n \"user_name\": \"Jane.Contact\",\n \"failed_attempts\": \"\",\n \"edu_status\": \"faculty\",\n \"latitude\": \"\",\n \"roles\": \"\",\n \"title\": \"\",\n \"sys_class_name\": \"customer_contact\",\n \"sys_id\": \"0a232a0013691200042ab3173244b075\",\n \"internal_integration_user\": \"false\",\n \"ldap_server\": \"\",\n \"mobile_phone\": \"\",\n \"street\": \"\",\n \"company\": \"86837a386f0331003b3c498f5d3ee4ca\",\n \"department\": \"\",\n \"first_name\": \"Jane\",\n \"preferred_language\": \"\",\n \"introduction\": \"\",\n \"email\": \"jane.contact@mailinator.com\",\n \"manager\": \"\",\n \"locked_out\": \"false\",\n \"sys_mod_count\": \"3\",\n \"last_name\": \"Contact\",\n \"photo\": \"\",\n \"sys_tags\": \"\",\n \"middle_name\": \"\",\n \"time_zone\": \"\",\n \"schedule\": \"\",\n \"on_schedule\": \"\",\n \"date_format\": \"\",\n \"location\": \"\",\n \"account\": \"86837a386f0331003b3c498f5d3ee4ca\"\n }\n ]\n}\n```\n\n## Contact - GET /now/contact/\\{id\\}\n\nRetrieves the specified Customer Service Management \\(CSM\\) contact.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/contact/{id}`\n\nDefault URL: `/api/now/contact/{id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n\n
\n\nName\n\n\n\nDescription\n\n
\n\napi\\_version\n\n\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n
\n\nid\n\n\n\nSys\\_id of the contact to retrieve.Data type: String\n\nTable: Contact \\[customer\\_contact\\]\n\n
|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n\n
\n\nHeader\n\n\n\nDescription\n\n
\n\nAccept\n\n\n\nData format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**\n\n
|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n\n
\n\nStatus code\n\n\n\nDescription\n\n
\n\n200\n\n\n\nSuccessful. The request was successfully processed.\n\n
\n\n401\n\n\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n
\n\n404\n\n\n\nIndicates that the request is invalid. Could be due to one of the following reasons:- Requested case doesn't exist.\n- User doesn't have access to the case.\n\n
\n\n500\n\n\n\nInternal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.\n\n
### Response body parameters \\(JSON or XML\\)\n\nThe endpoint may return the following JSON or XML elements in the response body. In addition to the list of elements defined below \\(which define the elements in a base system\\), the endpoint also returns any custom fields added to the Contact \\[customer\\_contact\\] table. For additional information on these elements, refer to your specific table definition \\[**System Definition** > **Tables**\\].\n\n\n
\n\nElement\n\n\n\nDescription\n\n
\n\naccount\n\n\n\nSys\\_id of the account record to which the contact is associated.Data type: String\n\nTable: Account \\[customer\\_account\\]\n\n
\n\nactive\n\n\n\nFlag that indicates whether the contact is active within the system.Possible values:\n\n- true: Contact is active\n- false: Contact is inactive\n\nData type: Boolean\n\nDefault: true\n\n
\n\nagent\\_status\n\n\n\nStatus of the agent.Possible values:\n\n- Off work\n- On break\n- On route\n- On site\n\nData type: String\n\nMaximum length: 40\n\n
\n\nbuilding\n\n\n\nSys\\_id of the record that describes the building in which the contact resides.Data type: String\n\nTable: Building \\[cmn\\_building\\]\n\n
\n\ncalendar\\_integration\n\n\n\nCalendar application that the contact uses.1: Outlook\n\nData type: Number \\(Integer\\)\n\nDefault: 1\n\n
\n\ncity\n\n\n\nCity in which the contact resides.Data type: String\n\nMaximum length: 40\n\n
\n\ncompany\n\n\n\nSys\\_id of the company record to which the contact is associated.Data type: String\n\nTable: Company \\[core\\_company\\]\n\n
\n\ncost\\_center\n\n\n\nSys\\_id of the cost center associated with the contact.Data type: String\n\nTable: Cost Center \\[cmn\\_cost\\_center\\]\n\n
\n\ncountry\n\n\n\nCountry code of the country in which the contact resides.Data type: String\n\nMaximum length: 3\n\n
\n\ndate\\_format\n\n\n\nFormat in which to display dates to contacts.Valid values:\n\n- dd/mm/yyyy\n- dd-mm-yyyy\n- dd.mm.yyyy\n- mm-dd-yyyy\n- yyyy-mm-dd\n\nData type: String\n\nMaximum length: 40\n\nDefault: blank \\(system date format\\)\n\n
\n\ndefault\\_perspective\n\n\n\nSys\\_id of the default perspective for the contact.Data type: String\n\nTable: Menu List \\[sys\\_perspective\\]\n\n
\n\ndepartment\n\n\n\nSys\\_id of the department associated with the contact.Data type: String\n\nTable: Department \\[cmn\\_department\\]\n\n
\n\nedu\\_status\n\n\n\nEducation status of the associated contact.Data type: String\n\nMaximum length: 40\n\nDefault: faculty\n\n
\n\nemail\n\n\n\nContact email address.Data type: String\n\n
\n\nemployee\\_number\n\n\n\nContact employee number.Data type: String\n\n
\n\nenable\\_multifactor\\_authn\n\n\n\nFlag that indicates whether multifactor authorization is required for the contact to log in to the service portal.Possible values:\n\n- true: Multifactor authorization enabled\n- false: Multifactor authorization disabled\n\nData type: Boolean\n\nDefault: false\n\n
\n\nfailed\\_attempts\n\n\n\nNumber of failed log in attempts.Data type: Number \\(Integer\\)\n\n
\n\nfirst\\_name\n\n\n\nContact first name.Data type: String\n\nMaximum length: 50\n\n
\n\ngender\n\n\n\nContact gender.Data type: String\n\nMaximum length: 40\n\n
\n\ngeolocation\\_tracked\n\n\n\nFlag that indicates whether the contact location is obtained through geotracking.Possible values:\n\n- true: Contact location obtained through geotracking\n- false: Contact location not obtained through geotracking\n\nData type: Boolean\n\nDefault value: false\n\n
\n\nhome\\_phone\n\n\n\nContact home phone number.Data type: String\n\nMaximum length: 40\n\n
\n\ninternal\\_integration\\_user\n\n\n\nFlag that indicates whether the contact is an internal integration user.Possible values:\n\n- true: Internal integration user\n- false: Other type of user\n\nData type: Boolean\n\nDefault: false\n\n
\n\nintroduction\n\n\n\nIntroductionData type: String\n\nMaximum length: 40\n\n
\n\nlast\\_login\n\n\n\nDate on which the contact last logged into the system.Data type: String \\(Date\\)\n\n
\n\nlast\\_login\\_device\n\n\n\nDevice the consumer used the last time they logged in to the system.Data type: String\n\nMaximum length: 40\n\n
\n\nlast\\_login\\_time\n\n\n\nDate and time the contact logged in to the system.Data type: String \\(Date/time\\)\n\n
\n\nlast\\_name\n\n\n\nContact last name.Data type: String\n\nMaximum length: 50\n\n
\n\nlast\\_position\\_update\n\n\n\nDate and time the last position was updated.Data type: String \\(Date/time\\)\n\n
\n\nlatitude\n\n\n\nLatitude coordinate of the contact.Data type: Number \\(Floating point\\)\n\nMaximum length: 40\n\n
\n\nldap\\_server\n\n\n\nSys\\_id of the LDAP server used by the contact to last log in to the system. Data type: String\n\nTable: LDAP Server \\[ldap\\_server\\_config\\]\n\n
\n\nlocation\n\n\n\nSys\\_id of the record that describes the location of the contactData type: String\n\nTable: Location \\[cmn\\_location\\]\n\n
\n\nlocked\\_out\n\n\n\nFlag that indicates if the contact is locked-out.Possible values:\n\n- true: Contact locked-out\n- false: Contact not locked-out\n\nData type: Boolean\n\nDefault: false\n\n
\n\nlongitude\n\n\n\nLongitude coordinate of the contact.Data type: Number \\(Floating point\\)\n\nMaximum length: 40\n\n
\n\nmanager\n\n\n\nSys\\_id of the record that describes the direct supervisor of the contact.Data type: String\n\nTable: User \\[sys\\_user\\]\n\n
\n\nmiddle\\_name\n\n\n\nContact middle name.Data type: Number \\(Floating point\\)\n\nMaximum length: 50\n\n
\n\nmobile\\_phone\n\n\n\nContact mobile phone number.Data type: String\n\n Maximum length: 40\n\n
\n\nname\n\n\n\nContact full name.Data type: String\n\nMaximum length: 151\n\n
\n\nnotification\n\n\n\nIndicates whether the contact should receive notifications.Valid values:\n\n- 1: Disabled\n- 2: Enabled\n\nData type: Number \\(Integer\\)\n\nDefault: 2\n\n
\n\non\\_schedule\n\n\n\nIndicates the timeliness of dispatched service personnel.Valid values:\n\n- Ahead: Ahead of schedule.\n- behind\\_less30: Behind schedule, but less than 30 minutes.\n- behind\\_30to60: Behind schedule between 30 and 60 minutes.\n- behind\\_more60: Behind schedule more than 60 minutes.\n- on\\_time: On schedule.\n\nData type: String\n\nMaximum length: 40\n\n
\n\nphone\n\n\n\nContact business phone number.Data type: String\n\nMaximum length: 40\n\n
\n\nphoto\n\n\n\nPhoto image of the contact. Data type: String\n\n
\n\npreferred\\_language\n\n\n\nCountry code of the contact primary language.Data type: String\n\nMaximum length: 3\n\n
\n\nroles\n\n\n\nList of user roles associated with the contact.Data type: String\n\nMaximum length: 40\n\n
\n\nschedule\n\n\n\nSys\\_id of the record that describes the work schedule for the associated contact.Data type: String\n\nTable: Schedule \\[cmn\\_schedule\\]\n\n
\n\nsource\n\n\n\nSource of the contact.Data type: String\n\nMaximum length: 255\n\n
\n\nstate\n\n\n\nState in which the contact resides.Data type: String\n\nMaximum length: 40\n\n
\n\nstreet\n\n\n\nContact street address.Data type: String\n\nMaximum length: 255\n\n
\n\nsys\\_class\\_name\n\n\n\nTable that contains the contact record. Data type: String\n\nMaximum length: 80\n\n
\n\nsys\\_created\\_by\n\n\n\nUser that originally created the associated contact record.Data type: String\n\nMaximum length: 40\n\n
\n\nsys\\_created\\_on\n\n\n\nData and time the associated contact was originally created.Data type: String \\(Date/time\\)\n\n
\n\nsys\\_domain\n\n\n\nServiceNow instance domain of the associated contact record.Data type: String\n\n
\n\nsys\\_domain\\_path\n\n\n\nContact record domain path.Data type: String\n\nMaximum length: 255\n\nDefault: / \\(global\\)\n\n
\n\nsys\\_id\n\n\n\nUnique identifier for the associated contact record.Data type: String\n\n
\n\nsys\\_mod\\_count\n\n\n\nNumber of times that the associated contact record has been modified.Data type: Number \\(Integer\\)\n\n
\n\nsys\\_updated\\_by\n\n\n\nUser that last updated the associated contact information.Data type: String\n\nMaximum length: 40\n\n
\n\nsys\\_updated\\_on\n\n\n\nData and time the associated contact information was updated.Data type: String \\(Date/time\\)\n\n
\n\ntime\\_format\n\n\n\nFormat in which to display time.Valid values:\n\n- hh.mm.ss a: hh.mm.ss \\(12 hour\\)\n- hh:mm:ss a: hh:mm:ss \\(12 hour\\)\n- HH.mm.ss: hh.mm.ss \\(24 hour\\)\n- HH:mm:ss: hh:mm:ss \\(24 hour\\)\n\nData type: String\n\nMaximum length: 40\n\nDefault: Blank \\(system time format\\)\n\n
\n\ntime\\_sheet\\_policy\n\n\n\nSys\\_id of the record that contains the time sheet policy for the associated contact.Data type: String\n\nTable: Time Sheet Policy \\[time\\_sheet\\_policy\\]\n\n
\n\ntime\\_zone\n\n\n\nTime zone in which the contact resides, such as Canada/Central or US/Eastern.Data type: String\n\nMaximum length: 40\n\n
\n\ntitle\n\n\n\nContact business title such as Manager, Software Developer, or Contractor.Data type: String\n\nMaximum length: 60\n\n
\n\nuser\\_name\n\n\n\nContact user ID.Data type: String\n\nMaximum length: 40\n\n
\n\nvip\n\n\n\nFlag that indicates whether the associated contact has VIP status.Possible values:\n\n- true: VIP\n- false: Not VIP\n\nData type: Boolean\n\nDefault: false\n\n
\n\nweb\\_service\\_access\\_only\n\n\n\nFlag that indicates whether the contact can only access services through the web.Possible values:\n\n- true: Web access only\n- false: Access through all available methods\n\nData type: Boolean\n\nDefault: false\n\n
\n\nzip\n\n\n\nContact zip code.Data type: String\n\nMaximum length: 40\n\n
### cURL request\n\n```\ncurl \"https://instance.servicenow.com/api/now/contact/ddce70866f9331003b3c498f5d3ee417 \\\n--request GET \\\n--header \"Accept:application/json\" \\\n--user \"username\":\"password\"\n\n```\n\n```\n{\n \"result\": {\n \"country\": \"\",\n \"calendar_integration\": \"1\",\n \"last_position_update\": \"\",\n \"last_login_time\": \"2018-03-10 21:48:11\",\n \"last_login_device\": \"\",\n \"source\": \"\",\n \"sys_updated_on\": \"2019-01-03 05:49:34\",\n \"building\": \"\",\n \"web_service_access_only\": \"false\",\n \"notification\": \"2\",\n \"sys_updated_by\": \"system\",\n \"enable_multifactor_authn\": \"false\",\n \"sys_created_on\": \"2018-03-04 20:26:32\",\n \"sys_domain\": \"global\",\n \"agent_status\": \"\",\n \"state\": \"\",\n \"vip\": \"false\",\n \"sys_created_by\": \"admin\",\n \"longitude\": \"\",\n \"zip\": \"\",\n \"home_phone\": \"\",\n \"time_format\": \"\",\n \"last_login\": \"\",\n \"default_perspective\": \"\",\n \"geolocation_tracked\": \"false\",\n \"active\": \"true\",\n \"time_sheet_policy\": \"\",\n \"sys_domain_path\": \"/\",\n \"phone\": \"+1 858 287 7834\",\n \"cost_center\": \"\",\n \"name\": \"George Warren\",\n \"employee_number\": \"\",\n \"gender\": \"\",\n \"city\": \"\",\n \"user_name\": \"george.warren\",\n \"failed_attempts\": \"\",\n \"edu_status\": \"\",\n \"latitude\": \"\",\n \"roles\": \"\",\n \"title\": \"Network Administrator\",\n \"sys_class_name\": \"customer_contact\",\n \"sys_id\": \"ddce70866f9331003b3c498f5d3ee417\",\n \"internal_integration_user\": \"false\",\n \"ldap_server\": \"\",\n \"mobile_phone\": \"+1 858 867 7857\",\n \"street\": \"\",\n \"company\": \"86837a386f0331003b3c498f5d3ee4ca\",\n \"department\": \"\",\n \"first_name\": \"George\",\n \"preferred_language\": \"\",\n \"introduction\": \"\",\n \"email\": \"geo.warren@mailinator.com\",\n \"manager\": \"\",\n \"locked_out\": \"false\",\n \"sys_mod_count\": \"3\",\n \"last_name\": \"Warren\",\n \"photo\": \"\",\n \"sys_tags\": \"\",\n \"middle_name\": \"\",\n \"time_zone\": \"\",\n \"schedule\": \"\",\n \"on_schedule\": \"\",\n \"date_format\": \"\",\n \"location\": \"25ab8e460a0a0bb300857304ff811af5\",\n \"account\": \"86837a386f0331003b3c498f5d3ee4ca\"\n }\n}\n\n```\n\n## Contact - POST /now/contact\n\nCreates a new Customer Service Management \\(CSM\\) contact.\n\nIn addition, you can create a social media profile for the contact using this endpoint. To create the profile, you must specify the following parameters in the request body:\n\n- **social\\_channel**\n- **social\\_handle**\n- **social\\_handle\\_url**\n\n**Warning:** This endpoint does not perform parameter validation as doing so can create excessive overhead. If a request parameter is misspelled, is not valid, or is not supported by the endpoint, it is ignored without warning.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/contact`\n\nDefault URL: `/api/now/contact`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n\n
\n\nName\n\n\n\nDescription\n\n
\n\napi\\_version\n\n\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n
|Name|Description|\n|----|-----------|\n|None| |\n\n\n
\n\nElement\n\n\n\nDescription\n\n
\n\naccount\n\n\n\nSys\\_id of the account record to which the contact is associated.Data type: String\n\nTable: Account \\[customer\\_account\\]\n\n
\n\nactive\n\n\n\nFlag that indicates whether the contact is active within the system.Possible values:\n\n- true: Contact is active\n- false: Contact is inactive\n\nData type: Boolean\n\nDefault: true\n\n
\n\nagent\\_status\n\n\n\nStatus of the agent.Possible values:\n\n- Off work\n- On break\n- On route\n- On site\n\nData type: String\n\nMaximum length: 40\n\n
\n\nbuilding\n\n\n\nSys\\_id of the record that describes the building in which the contact resides.Data type: String\n\nTable: Building \\[cmn\\_building\\]\n\n
\n\ncalendar\\_integration\n\n\n\nCalendar application that the contact uses.1: Outlook\n\nData type: Number \\(Integer\\)\n\nDefault: 1\n\n
\n\ncity\n\n\n\nCity in which the contact resides.Data type: String\n\nMaximum length: 40\n\n
\n\ncompany\n\n\n\nSys\\_id of the company record to which the contact is associated.Data type: String\n\nTable: Company \\[core\\_company\\]\n\n
\n\ncost\\_center\n\n\n\nSys\\_id of the cost center associated with the contact.Data type: String\n\nTable: Cost Center \\[cmn\\_cost\\_center\\]\n\n
\n\ncountry\n\n\n\nCountry code of the country in which the contact resides.Data type: String\n\nMaximum length: 3\n\n
\n\ndate\\_format\n\n\n\nFormat in which to display dates to contacts.Valid values:\n\n- dd/mm/yyyy\n- dd-mm-yyyy\n- dd.mm.yyyy\n- mm-dd-yyyy\n- yyyy-mm-dd\n\nData type: String\n\nMaximum length: 40\n\nDefault: blank \\(system date format\\)\n\n
\n\ndefault\\_perspective\n\n\n\nSys\\_id of the default perspective for the contact.Data type: String\n\nTable: Menu List \\[sys\\_perspective\\]\n\n
\n\ndepartment\n\n\n\nSys\\_id of the department associated with the contact.Data type: String\n\nTable: Department \\[cmn\\_department\\]\n\n
\n\nedu\\_status\n\n\n\nEducation status of the associated contact.Data type: String\n\nMaximum length: 40\n\nDefault: faculty\n\n
\n\nemail\n\n\n\nContact email address.Data type: String\n\n
\n\nemployee\\_number\n\n\n\nContact employee number.Data type: String\n\n
\n\nenable\\_multifactor\\_authn\n\n\n\nFlag that indicates whether multifactor authorization is required for the contact to log in to the service portal.Possible values:\n\n- true: Multifactor authorization enabled\n- false: Multifactor authorization disabled\n\nData type: Boolean\n\nDefault: false\n\n
\n\nfailed\\_attempts\n\n\n\nNumber of failed log in attempts.Data type: Number \\(Integer\\)\n\n
\n\nfirst\\_name\n\n\n\nContact first name.Data type: String\n\nMaximum length: 50\n\n
\n\ngender\n\n\n\nContact gender.Data type: String\n\nMaximum length: 40\n\n
\n\ngeolocation\\_tracked\n\n\n\nFlag that indicates whether the contact location is obtained through geotracking.Possible values:\n\n- true: Contact location obtained through geotracking\n- false: Contact location not obtained through geotracking\n\nData type: Boolean\n\nDefault value: false\n\n
\n\nhome\\_phone\n\n\n\nContact home phone number.Data type: String\n\nMaximum length: 40\n\n
\n\ninternal\\_integration\\_user\n\n\n\nFlag that indicates whether the contact is an internal integration user.Possible values:\n\n- true: Internal integration user\n- false: Other type of user\n\nData type: Boolean\n\nDefault: false\n\n
\n\nintroduction\n\n\n\nIntroductionData type: String\n\nMaximum length: 40\n\n
\n\nlast\\_login\\_device\n\n\n\nDevice the consumer used the last time they logged in to the system.Data type: String\n\nMaximum length: 40\n\n
\n\nlast\\_login\\_time\n\n\n\nDate and time the contact logged in to the system.Data type: String \\(Date/time\\)\n\n
\n\nlast\\_name\n\n\n\nContact last name.Data type: String\n\nMaximum length: 50\n\n
\n\nlatitude\n\n\n\nLatitude coordinate of the contact.Data type: Number \\(Floating point\\)\n\nMaximum length: 40\n\n
\n\nldap\\_server\n\n\n\nSys\\_id of the LDAP server used by the contact to last log in to the system. Data type: String\n\nTable: LDAP Server \\[ldap\\_server\\_config\\]\n\n
\n\nlocation\n\n\n\nSys\\_id of the record that describes the location of the contactData type: String\n\nTable: Location \\[cmn\\_location\\]\n\n
\n\nlocked\\_out\n\n\n\nFlag that indicates if the contact is locked-out.Possible values:\n\n- true: Contact locked-out\n- false: Contact not locked-out\n\nData type: Boolean\n\nDefault: false\n\n
\n\nlongitude\n\n\n\nLongitude coordinate of the contact.Data type: Number \\(Floating point\\)\n\nMaximum length: 40\n\n
\n\nmanager\n\n\n\nSys\\_id of the record that describes the direct supervisor of the contact.Data type: String\n\nTable: User \\[sys\\_user\\]\n\n
\n\nmiddle\\_name\n\n\n\nContact middle name.Data type: Number \\(Floating point\\)\n\nMaximum length: 50\n\n
\n\nmobile\\_phone\n\n\n\nContact mobile phone number.Data type: String\n\n Maximum length: 40\n\n
\n\nname\n\n\n\nContact full name.Data type: String\n\nMaximum length: 151\n\n
\n\nnotification\n\n\n\nIndicates whether the contact should receive notifications.Valid values:\n\n- 1: Disabled\n- 2: Enabled\n\nData type: Number \\(Integer\\)\n\nDefault: 2\n\n
\n\non\\_schedule\n\n\n\nIndicates the timeliness of dispatched service personnel.Valid values:\n\n- Ahead: Ahead of schedule.\n- behind\\_less30: Behind schedule, but less than 30 minutes.\n- behind\\_30to60: Behind schedule between 30 and 60 minutes.\n- behind\\_more60: Behind schedule more than 60 minutes.\n- on\\_time: On schedule.\n\nData type: String\n\nMaximum length: 40\n\n
\n\nphone\n\n\n\nContact business phone number.Data type: String\n\nMaximum length: 40\n\n
\n\nphoto\n\n\n\nPhoto image of the contact. Data type: String\n\n
\n\npreferred\\_language\n\n\n\nCountry code of the contact primary language.Data type: String\n\nMaximum length: 3\n\n
\n\nroles\n\n\n\nList of user roles associated with the contact.Data type: String\n\nMaximum length: 40\n\n
\n\nschedule\n\n\n\nSys\\_id of the record that describes the work schedule for the associated contact.Data type: String\n\nTable: Schedule \\[cmn\\_schedule\\]\n\n
\n\nsocial\\_channel\n\n\n\nSocial media channel to which the contact is associated such as Twitter, Facebook, or Instagram.Data type: String\n\n
\n\nsocial\\_handle\n\n\n\nUser handle on the social media channel.Data type: String\n\n
\n\nsocial\\_handle\\_url\n\n\n\nURL to the contact's social channel profile.Data type: String\n\n
\n\nsource\n\n\n\nSource of the contact.Data type: String\n\nMaximum length: 255\n\n
\n\nstate\n\n\n\nState in which the contact resides.Data type: String\n\nMaximum length: 40\n\n
\n\nstreet\n\n\n\nContact street address.Data type: String\n\nMaximum length: 255\n\n
\n\ntime\\_format\n\n\n\nFormat in which to display time.Valid values:\n\n- hh.mm.ss a: hh.mm.ss \\(12 hour\\)\n- hh:mm:ss a: hh:mm:ss \\(12 hour\\)\n- HH.mm.ss: hh.mm.ss \\(24 hour\\)\n- HH:mm:ss: hh:mm:ss \\(24 hour\\)\n\nData type: String\n\nMaximum length: 40\n\nDefault: Blank \\(system time format\\)\n\n
\n\ntime\\_sheet\\_policy\n\n\n\nSys\\_id of the record that contains the time sheet policy for the associated contact.Data type: String\n\nTable: Time Sheet Policy \\[time\\_sheet\\_policy\\]\n\n
\n\ntime\\_zone\n\n\n\nTime zone in which the contact resides, such as Canada/Central or US/Eastern.Data type: String\n\nMaximum length: 40\n\n
\n\ntitle\n\n\n\nContact business title such as Manager, Software Developer, or Contractor.Data type: String\n\nMaximum length: 60\n\n
\n\nuser\\_name\n\n\n\nContact user ID.Data type: String\n\nMaximum length: 40\n\n
\n\nvip\n\n\n\nFlag that indicates whether the associated contact has VIP status.Possible values:\n\n- true: VIP\n- false: Not VIP\n\nData type: Boolean\n\nDefault: false\n\n
\n\nweb\\_service\\_access\\_only\n\n\n\nFlag that indicates whether the contact can only access services through the web.Possible values:\n\n- true: Web access only\n- false: Access through all available methods\n\nData type: Boolean\n\nDefault: false\n\n
\n\nzip\n\n\n\nContact zip code.Data type: String\n\nMaximum length: 40\n\n
### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|Accept|Data format of the response body. Only supports **application/json**.|\n|Content-Type|Data format of the request body. Only supports **application/json**.|\n\n|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|201|New contact record was successfully created.|\n|400|Bad Request. A bad request type or malformed request was detected.|\n|401|Unauthorized. The user credentials are incorrect or have not been passed.|\n|500|Internal Server Error. A logic error on the server-side code occurred.|\n\n### Response body parameters \\(JSON or XML\\)\n\n\n
\n\nElement\n\n\n\nDescription\n\n
\n\nresult\n\n\n\nSys\\_id of the newly created contact record.Data type: String\n\n
### cURL request\n\n```\ncurl -X POST \"https://instance.servicenow.com/api/now/contact\" \\\n-H 'Accept: application/json' \\\n-H 'Content-Type: application/json' \\\n-d '{ \\\n \"country\": \"USA\", \\\n \"calendar_integration\": \"1\", \\\n \"last_login_time\": \"2018-03-10 21:48:11\", \\\n \"last_login_device\": \"tablet\", \\\n \"building\": \"Cardinal West\", \\\n \"web_service_access_only\": \"false\", \\\n \"notification\": \"1\", \\\n \"enable_multifactor_authn\": \"true\", \\\n \"agent_status\": \"Travelling\", \\\n \"state\": \"CA\", \\\n \"vip\": \"false\", \\\n \"longitude\": \"123.76\", \\\n \"zip\": \"92069\", \\\n \"home_phone\": \"(555)555-1234\", \\\n \"time_format\": \"hh:mm:ss\", \\\n \"geolocation_tracked\": \"false\", \\\n \"active\": \"true\", \\\n \"phone\": \"+1 858 287 7834\", \\\n \"cost_center\": \"1345\", \\\n \"name\": \"Dora Warren\", \\\n \"employee_number\": \"546\", \\\n \"gender\": \"Female\", \\\n \"city\": \"Orlando\", \\\n \"user_name\": \"dora.warren\", \\\n \"failed_attempts\": \"2\", \\\n \"edu_status\": \"current\", \\\n \"latitude\": \"57.6\", \\\n \"title\": \"Network Administrator\", \\\n \"internal_integration_user\": \"false\", \\\n \"ldap_server\": \"10.24.23.123\", \\\n \"mobile_phone\": \"+1 858 867 7857\", \\\n \"street\": \"123 Lagume\", \\\n \"company\": \"86837a386f0331003b3c498f5d3ee4ca\", \\\n \"department\": \"IT\", \\\n \"first_name\": \"Dora\", \\\n \"preferred_language\": \"Spanish\", \\\n \"email\": \"dora.warren@mailinator.com\", \\\n \"manager\": \"ddce70866f9331003b3c498f5d3ee417\", \\\n \"locked_out\": \"false\", \\\n \"last_name\": \"Warren\", \\\n \"middle_name\": \"Dell\", \\\n \"time_zone\": \"PST\", \\\n \"schedule\": \"9-5\", \\\n \"date_format\": \"MM/DD/YY\", \\\n \"location\": \"25ab8e460a0a0bb300857304ff811af5\", \\\n \"account\": \"86837a386f0331003b3c498f5d3ee4ca\" \\\n}'\n--user 'username':'password'\n```\n\n```\n\"result\": \"62fe1c97db76c3006b7a9646db961999\"\n```\n\n"}}