---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Kontakt-API

# Kontakt-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 21 Minuten Lesedauer

Die Kontakt Die API stellt Endpunkte bereit, mit denen Sie sie abrufen und aktualisieren können Kundenservice-Management (CSM)Kontaktdatensätze.
Darüber hinaus können Sie beim Erstellen eines Kontakts neue Social Media-Profildatensätze generieren.

Die Kontakt API erfordert das Kundenservice-Plugin (com.sn_customerservice) und wird in bereitgestellt `Jetzt `Namespace.

Anwender benötigen die Rolle „csm_WS_Integration" für vollständigen API-Zugriff.

## Kontakt -- GET /now/contact {#ariaid-title2}

Ruft einen angegebenen Satz von ab Kundenservice-Management (CSM)Kontakte.

### URL-Format

Versionierte URL: /api/now/{api_Version}/contact

Standard-URL: /api/now/contact  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#contact-GET__entry__2}{#contact-GET__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#contact-GET__entry__6}{#contact-GET__sysparm-limit-entry}{#contact-GET__sysparm-offset-entry}{#contact-GET__sysparm-query-entry}

| Name | Beschreibung |
|-|-|
| Sysparm_limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie sysparm_offsetParameter zum Paginieren des Datensatzabrufs. In der Antwort der boolesche Parameter hasMoreWird zurückgegeben. Gibt an, ob weitere zurückzugebende Datensätze vorhanden sind, die die Filterkriterien erfüllen. Datentyp: Zahl Standard: 10 |
| Sysparm_Offset | Startdatensatzindex, für den mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktionalität ermöglicht den Abruf aller Datensätze, unabhängig von der Anzahl der Datensätze, in kleinen verwaltbaren Blöcken. Beispiel: Wenn Sie diesen Endpunkt zum ersten Mal aufrufen, sysparm_offsetIst auf „0" festgelegt. Um einfach alle verfügbaren Datensätze durchzublättern, verwenden Sie `Sysparm_Offset=sysparm_Offset+sysparm_limit `, Bis Sie das Ende aller Datensätze erreichen. Übergeben Sie keine negative Zahl in sysparm_offsetParameter. Datentyp: Zahl Standard: 0 |
| Sysparm_query | Codierte Abfrage, die zum Filtern des Ergebnissatzes verwendet wird. Zum Beispiel: `Sysparm_query=caller_ID=javascript:gs.getUserID()^Active=wahr` Die codierte Abfrage unterstützt Sortieren nach . Um Antworten basierend auf bestimmten Feldern zu sortieren, verwenden Sie SORTIEREN NACH Und ORDERBYDESC Klauseln in sysparm_query. Beispiel: `Sysparm_query=Active=wahr^ORDERBYNummer^ORDERBYDESCCATEGORY `Filtert alle aktiven Datensätze und ordnet die Ergebnisse zuerst in aufsteigender Reihenfolge nach Zahl und dann in absteigender Reihenfolge nach Kategorie an. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Gibt dann Zeilen zurück, die nur den gültigen Teil der Abfrage verwenden. Sie können dieses Verhalten mithilfe der Eigenschaft steuern glide.invalid_query.returns_no_rows. Legen Sie diese Eigenschaft auf „wahr" fest, um keine Zeilen für eine ungültige Abfrage zurückzugeben. Hinweis: Die glide.invalid_query.returns_no_rowsEigenschaft steuert das Verhalten aller Abfragen in der Instanz, z. B. in Listen, Skripts ( GlideRecord.Abfrage() ) Und Webservice-APIs. Datentyp: Zeichenfolge |
[Tabelle : 2. Abfrageparameter]

{#contact-GET__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#contact-GET__entry__18}{#contact-GET__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#contact-GET__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#contact-GET__entry__26}{#contact-GET__entry-200-status-code}{#contact-GET__entry-500-status-code}{#contact-GET__d2856e880}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

Der Endpunkt kann die folgenden JSON- oder XML-Elemente im Antworttext zurückgeben. Zusätzlich zur Liste der unten definierten Elemente (die die Elemente in einem Basissystem definieren) gibt der Endpunkt auch alle anwenderdefinierten Felder zurück, die der Tabelle „Kontakt" \[Customer_contact\] hinzugefügt wurden. Weitere Informationen zu diesen Elementen finden Sie in Ihrer spezifischen Tabellendefinition \[SystemdefinitionTabellen\].
{#contact-GET__csmcontact_response_parms__entry__2}{#contact-GET__contacttable-account-enrty}{#contact-GET__contacttable-active-entry}{#contact-GET__contacttable-agent_status-entry}{#contact-GET__contacttable-building-entry}{#contact-GET__contacttable-calendar_integration-entry}{#contact-GET__contacttable-city-entry}{#contact-GET__contacttable-company-entry}{#contact-GET__contacttable-cost_center-entry}{#contact-GET__contacttable-country-entry}{#contact-GET__contacttable-date_format-entry}{#contact-GET__contacttable-default_perspective-entry}{#contact-GET__contacttable-department-entry}{#contact-GET__contacttable-edu_status-entry}{#contact-GET__contacttable-email-entry}{#contact-GET__contacttable-employee_number-entry}{#contact-GET__contacttable-enable_multifactor_authn-entry}{#contact-GET__contacttable-failed_attempts-entry}{#contact-GET__contacttable-first_name-entry}{#contact-GET__contacttable-gender-entry}{#contact-GET__contacttable-geolocation_tracked-entry}{#contact-GET__contacttable-home_phone-entry}{#contact-GET__contacttable-internal_integration_user-entry}{#contact-GET__contacttable-introduction-entry}{#contact-GET__contacttable-last_login-entry}{#contact-GET__contacttable-last_login_device-entry}{#contact-GET__contacttable-last_login_time-entry}{#contact-GET__contacttable-last_name-entry}{#contact-GET__contacttable-last_position_update-entry}{#contact-GET__contacttable-latitude-entry}{#contact-GET__contacttable-ldap_server-entry}{#contact-GET__contacttable-location-entry}{#contact-GET__contacttable-locked_out-entry}{#contact-GET__contacttable-longitude-entry}{#contact-GET__contacttable-manager-entry}{#contact-GET__contacttable-middle_name-entry}{#contact-GET__contacttable-mobile_phone-entry}{#contact-GET__contacttable-name-entry}{#contact-GET__contacttable-notification-entry}{#contact-GET__contacttable-on_schedule-entry}{#contact-GET__contacttable-phone-entry}{#contact-GET__contacttable-photo-entry}{#contact-GET__contacttable-preferred_language-entry}{#contact-GET__contacttable-roles-entry}{#contact-GET__contacttable-schedule-entry}{#contact-GET__contacttable-source-entry}{#contact-GET__contacttable-state-entry}{#contact-GET__contacttable-street-entry}{#contact-GET__contacttable-sys_class_name-entry}{#contact-GET__contacttable-sys_created_by-entry}{#contact-GET__contacttable-sys_created_on-entry}{#contact-GET__contacttable-sys_domain-entry}{#contact-GET__contacttable-sys_domain_path-entry}{#contact-GET__contacttable-sys_id-entry}{#contact-GET__contacttable-sys_mod_count-entry}{#contact-GET__contacttable-sys_updated_by-entry}{#contact-GET__contacttable-sys_updated_on-entry}{#contact-GET__contacttable-time_format-entry}{#contact-GET__contacttable-time_sheet_policy-entry}{#contact-GET__contacttable-time_zone-entry}{#contact-GET__contacttable-title-entry}{#contact-GET__contacttable-user_name-entry}{#contact-GET__contacttable-vip-entry}{#contact-GET__contacttable-web_service_access_only-entry}{#contact-GET__contacttable-zip-entry}

| Element | Beschreibung |
|-|-|
| Account | SYS_ID des Account-Datensatzes, dem der Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\] |
| aktiv | Kennzeichnung, die angibt, ob der Kontakt im System aktiv ist. Mögliche Werte: * Wahr: Kontakt ist aktiv * Falsch: Kontakt ist inaktiv Datentyp: Boolescher Wert Standard: Wahr |
| Agent_Status | Status des Service Desk-Mitarbeiters. Mögliche Werte: * Nicht in Arbeit * In Pause * Unterwegs * Am Standort Datentyp: Zeichenfolge Maximale Länge: 40 |
| Gebäude | SYS_ID des Datensatzes, der das Gebäude beschreibt, in dem sich der Kontakt befindet. Datentyp: Zeichenfolge Tabelle: Gebäude \[cmn_Building\] |
| Calendar_Integration | Kalenderanwendung, die der Kontakt verwendet. 1: Outlook Datentyp: Zahl (Ganzzahl) Standard: 1 |
| city | Stadt, in der sich der Kontakt befindet. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Unternehmen | SYS_ID des Unternehmensdatensatzes, dem der Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Unternehmen \[Core_Company\] |
| Kostenstelle | SYS_ID der Kostenstelle, die dem Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Kostenstelle \[cmn_Cost_Center\] |
| country | Ländercode des Landes, in dem der Kontakt ansässig ist. Datentyp: Zeichenfolge Maximale Länge: 3 |
| Datum_Format | Format, in dem Daten für Kontakte angezeigt werden sollen. Gültige Werte: * TT/MM/JJJJ * TT-MM-JJJJ * TT.MM.JJJJ * MM-TT-JJJJ * JJJJ-MM-TT Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Leer (Systemdatumsformat) |
| Default_perspective | SYS_ID der Standardperspektive für den Kontakt. Datentyp: Zeichenfolge Tabelle: Menüliste \[sys_perspective\] |
| department | SYS_ID der Abteilung, die dem Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Abteilung \[cmn_Department\] |
| edu_Status | Bildungsstatus des zugehörigen Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Fakultät |
| E-Mail | E-Mail-Adresse des Kontakts. Datentyp: Zeichenfolge |
| Employee_number | Kontaktmitarbeiternummer. Datentyp: Zeichenfolge |
| Enable_multifactor_authn | Kennzeichnung, die angibt, ob eine Multifaktor-Autorisierung erforderlich ist, damit sich der Kontakt beim Serviceportal anmeldet. Mögliche Werte: * Wahr: Multifaktor-Autorisierung aktiviert * Falsch: Multifaktor-Autorisierung deaktiviert Datentyp: Boolescher Wert Standard: Falsch |
| Failed_attempts | Anzahl der fehlgeschlagenen Anmeldeversuche. Datentyp: Zahl (Ganzzahl) |
| first_name | Vorname des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 50 |
| Geschlecht | Kontaktgeschlecht. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Positionsbestimmung_nachverfolgt | Kennzeichnung, die angibt, ob der Kontaktstandort über GeoTracking abgerufen wird. Mögliche Werte: * Wahr: Kontaktstandort durch GeoTracking abgerufen * Falsch: Kontaktstandort nicht durch GeoTracking abgerufen Datentyp: Boolescher Wert Standardwert: falsch |
| home_phone | Telefonnummer des Kontakts (privat). Datentyp: Zeichenfolge Maximale Länge: 40 |
| Internal_Integration_user | Kennzeichnung, die angibt, ob der Kontakt ein interner Integrationsanwender ist. Mögliche Werte: * Wahr: Interner Integrationsanwender * Falsch: Anderer Anwendertyp Datentyp: Boolescher Wert Standard: Falsch |
| Einführung | Einführung Datentyp: Zeichenfolge Maximale Länge: 40 |
| Last_login | Datum, an dem sich der Kontakt zuletzt beim System angemeldet hat. Datentyp: Zeichenfolge (Datum) |
| Last_login_device | Gerät, das der Verbraucher bei der letzten Anmeldung beim System verwendet hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Last_login_time | Datum und Uhrzeit der Anmeldung des Kontakts beim System. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| last_name | Nachname des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 50 |
| Last_Position_Update | Datum und Uhrzeit der letzten Aktualisierung der Position. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| latitude | Breitengradkoordinate des Kontakts. Datentyp: Zahl (Gleitkomma) Maximale Länge: 40 |
| ldap_Server | SYS_ID des LDAP-Servers, der vom Kontakt verwendet wurde, um sich zuletzt beim System anzumelden. Datentyp: Zeichenfolge Tabelle: LDAP-Server \[ldap_Server_config\] |
| location | SYS_ID des Datensatzes, der den Standort des Kontakts beschreibt Datentyp: Zeichenfolge Tabelle: Standort \[cmn_location\] |
| Gesperrt_out | Kennzeichnung, die angibt, ob der Kontakt gesperrt ist. Mögliche Werte: * Wahr: Kontakt gesperrt * Falsch: Kontakt nicht gesperrt Datentyp: Boolescher Wert Standard: Falsch |
| longitude | Längengradkoordinate des Kontakts. Datentyp: Zahl (Gleitkomma) Maximale Länge: 40 |
| Manager | SYS_ID des Datensatzes, der den direkten Vorgesetzten des Kontakts beschreibt. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Middle_Name | Zweiter Vorname des Kontakts. Datentyp: Zahl (Gleitkomma) Maximale Länge: 50 |
| mobile_phone | Mobiltelefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| name | Vollständiger Name des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 151 |
| Benachrichtigung | Gibt an, ob der Kontakt Benachrichtigungen erhalten soll. Gültige Werte: * 1: Deaktiviert * 2: Aktiviert Datentyp: Zahl (Ganzzahl) Standard: 2 |
| On_schedule | Gibt die Aktualität des entsandten Servicepersonals an. Gültige Werte: * Voraus: Vor dem Zeitplan. * Hinter_less30: Hinter Zeitplan, aber weniger als 30 Minuten. * Hinter_30to60: Hinter Zeitplan zwischen 30 und 60 Minuten. * Hinter_more60: Mehr als 60 Minuten hinter Zeitplan. * On_time: Im Zeitplan. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Telefon | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Foto | Foto des Kontakts. Datentyp: Zeichenfolge |
| Preferred_language | Ländercode der primären Sprache des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 3 |
| Rollen | Liste der Anwenderrollen, die dem Kontakt zugeordnet sind. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Zeitplan | SYS_ID des Datensatzes, der den Arbeitszeitplan für den zugehörigen Kontakt beschreibt. Datentyp: Zeichenfolge Tabelle: Zeitplan \[cmn_schedule\] |
| Quelle | Quelle des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Staat | Status, in dem sich der Kontakt befindet. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Straße | Straße und Hausnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| sys_class_name | Tabelle, die den Kontaktdatensatz enthält. Datentyp: Zeichenfolge Maximale Länge: 80 |
| sys_created_by | Anwender, der ursprünglich den zugehörigen Kontaktdatensatz erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_created_on | Daten und Uhrzeit der ursprünglichen Erstellung des zugehörigen Kontakts. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| sys_Domain | ServiceNow Instanzdomäne des zugehörigen Kontaktdatensatzes. Datentyp: Zeichenfolge |
| sys_Domain_path | Domänenpfad des Kontaktdatensatzes. Datentyp: Zeichenfolge Maximale Länge: 255 Standard: / (Global) |
| sys_id | Eindeutiger Bezeichner für den zugehörigen Kontaktdatensatz. Datentyp: Zeichenfolge |
| sys_mod_count | Gibt an, wie oft der zugeordnete Kontaktdatensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| sys_Tags | System-Tags. Datentyp: Zeichenfolge |
| sys_updated_by | Anwender, der die zugehörigen Kontaktinformationen zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_updated_on | Daten und Uhrzeit der Aktualisierung der zugehörigen Kontaktinformationen. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| Time_Format | Format, in dem die Zeit angezeigt werden soll. Gültige Werte: * hh.mm.ss A: hh.mm.ss (12 Stunden) * hh:mm:ss a: hh:mm:ss (12 Stunden) * HH.mm.ss: hh.mm.ss (24 Stunden) * HH:mm:ss: hh:mm:ss (24 Stunden) Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Leer (Systemzeitformat) |
| Time_sheet_Policy | SYS_ID des Datensatzes, der die Zeitnachweisrichtlinie für den zugehörigen Kontakt enthält. Datentyp: Zeichenfolge Tabelle: Zeitnachweisrichtlinie \[time_sheet_Policy\] |
| Time_Zone | Zeitzone, in der sich der Kontakt befindet, z. B. Kanada/Zentral oder USA/Ost. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Titel | Geschäftstitel des Kontakts, z. B. Manager, Softwareentwickler oder Auftragnehmer. Datentyp: Zeichenfolge Maximale Länge: 60 |
| user_name | Kontaktanwender-ID. Datentyp: Zeichenfolge Maximale Länge: 40 |
| vip | Kennzeichnung, die angibt, ob der zugeordnete Kontakt den VIP-Status hat. Mögliche Werte: * Wahr: VIP * Falsch: Nicht VIP Datentyp: Boolescher Wert Standard: Falsch |
| web_service_access_only | Kennzeichnung, die angibt, ob der Kontakt nur über das Web auf Services zugreifen kann. Mögliche Werte: * Wahr: Nur Webzugriff * Falsch: Zugriff über alle verfügbaren Methoden Datentyp: Boolescher Wert Standard: Falsch |
| Postleitzahl | Postleitzahl des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
[ ]

### Curl-Anforderung

    curl "https://instance.servicenow.com/api/now/contact?sysparm_query=account=86837a386f0331003b3c498f5d3ee4ca&sysparm_limit=2&sysparm_offset=2>;rel="next" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    {
      "result": [
        {
          "country": "",
          "calendar_integration": "1",
          "last_position_update": "",
          "last_login_time": "2018-03-10 21:48:11",
          "last_login_device": "",
          "source": "",
          "sys_updated_on": "2019-01-03 05:49:34",
          "building": "",
          "web_service_access_only": "false",
          "notification": "2",
          "sys_updated_by": "system",
          "enable_multifactor_authn": "false",
          "sys_created_on": "2018-03-04 20:26:32",
          "sys_domain": "global",
          "agent_status": "",
          "state": "",
          "vip": "false",
          "sys_created_by": "admin",
          "longitude": "",
          "zip": "",
          "home_phone": "",
          "time_format": "",
          "last_login": "",
          "default_perspective": "",
          "geolocation_tracked": "false",
          "active": "true",
          "time_sheet_policy": "",
          "sys_domain_path": "/",
          "phone": "+1 858 287 7834",
          "cost_center": "",
          "name": "George Warren",
          "employee_number": "",
          "gender": "",
          "city": "",
          "user_name": "george.warren",
          "failed_attempts": "",
          "edu_status": "",
          "latitude": "",
          "roles": "",
          "title": "Network Administrator",
          "sys_class_name": "customer_contact",
          "sys_id": "ddce70866f9331003b3c498f5d3ee417",
          "internal_integration_user": "false",
          "ldap_server": "",
          "mobile_phone": "+1 858 867 7857",
          "street": "",
          "company": "86837a386f0331003b3c498f5d3ee4ca",
          "department": "",
          "first_name": "George",
          "preferred_language": "",
          "introduction": "",
          "email": "geo.warren@mailinator.com",
          "manager": "",
          "locked_out": "false",
          "sys_mod_count": "3",
          "last_name": "Warren",
          "photo": "",
          "sys_tags": "",
          "middle_name": "",
          "time_zone": "",
          "schedule": "",
          "on_schedule": "",
          "date_format": "",
          "location": "25ab8e460a0a0bb300857304ff811af5",
          "account": "86837a386f0331003b3c498f5d3ee4ca"
        },
        {
          "country": "",
          "calendar_integration": "1",
          "last_position_update": "",
          "last_login_time": "2019-01-03 15:08:57",
          "last_login_device": "73.71.157.241",
          "source": "",
          "sys_updated_on": "2019-01-03 23:26:12",
          "building": "",
          "web_service_access_only": "false",
          "notification": "2",
          "sys_updated_by": "admin",
          "enable_multifactor_authn": "false",
          "sys_created_on": "2019-01-03 15:07:25",
          "sys_domain": "global",
          "agent_status": "",
          "state": "",
          "vip": "false",
          "sys_created_by": "carl.customer",
          "longitude": "",
          "zip": "",
          "home_phone": "",
          "time_format": "",
          "last_login": "",
          "default_perspective": "",
          "geolocation_tracked": "false",
          "active": "true",
          "time_sheet_policy": "",
          "sys_domain_path": "/",
          "phone": "+16692627777",
          "cost_center": "",
          "name": "Jane Contact",
          "employee_number": "",
          "gender": "",
          "city": "",
          "user_name": "Jane.Contact",
          "failed_attempts": "",
          "edu_status": "faculty",
          "latitude": "",
          "roles": "",
          "title": "",
          "sys_class_name": "customer_contact",
          "sys_id": "0a232a0013691200042ab3173244b075",
          "internal_integration_user": "false",
          "ldap_server": "",
          "mobile_phone": "",
          "street": "",
          "company": "86837a386f0331003b3c498f5d3ee4ca",
          "department": "",
          "first_name": "Jane",
          "preferred_language": "",
          "introduction": "",
          "email": "jane.contact@mailinator.com",
          "manager": "",
          "locked_out": "false",
          "sys_mod_count": "3",
          "last_name": "Contact",
          "photo": "",
          "sys_tags": "",
          "middle_name": "",
          "time_zone": "",
          "schedule": "",
          "on_schedule": "",
          "date_format": "",
          "location": "",
          "account": "86837a386f0331003b3c498f5d3ee4ca"
        }
      ]
    }

## Kontakt -- GET /now/contact/{ID} {#ariaid-title3}

Ruft die angegebene ab Kundenservice-Management (CSM)Kontakt.

### URL-Format

Versionierte URL: /api/now/{api_Version}/contact/{ID}

Standard-URL: /api/now/contact/{ID}  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#contact-GET-id__entry__2}{#contact-GET-id__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| ID | SYS_ID des abzurufenden Kontakts. Datentyp: Zeichenfolge Tabelle: Kontakt \[Customer_contact\] |
[Tabelle : 7. Pfad-Parameter]

{#contact-GET-id__entry__8}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#contact-GET-id__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#contact-GET-id__entry__16}{#contact-GET-id__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

{#contact-GET-id__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#contact-GET-id__entry__24}{#contact-GET-id__entry-200-status-code}{#contact-GET-id__entry-401-status-code}{#contact-GET-id__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Gibt an, dass die Anforderung ungültig ist. Dies kann aus einem der folgenden Gründe liegen: * Angeforderter Fall ist nicht vorhanden. * Anwender hat keinen Zugriff auf den Fall. {#contact-GET-id__ul_ubm_1jl_3v} |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

Der Endpunkt kann die folgenden JSON- oder XML-Elemente im Antworttext zurückgeben. Zusätzlich zur Liste der unten definierten Elemente (die die Elemente in einem Basissystem definieren) gibt der Endpunkt auch alle anwenderdefinierten Felder zurück, die der Tabelle „Kontakt" \[Customer_contact\] hinzugefügt wurden. Weitere Informationen zu diesen Elementen finden Sie in Ihrer spezifischen Tabellendefinition \[SystemdefinitionTabellen\].
{#contact-GET-id__csmcontact_response_parms__entry__2}{#contact-GET-id__contacttable-account-enrty}{#contact-GET-id__contacttable-active-entry}{#contact-GET-id__contacttable-agent_status-entry}{#contact-GET-id__contacttable-building-entry}{#contact-GET-id__contacttable-calendar_integration-entry}{#contact-GET-id__contacttable-city-entry}{#contact-GET-id__contacttable-company-entry}{#contact-GET-id__contacttable-cost_center-entry}{#contact-GET-id__contacttable-country-entry}{#contact-GET-id__contacttable-date_format-entry}{#contact-GET-id__contacttable-default_perspective-entry}{#contact-GET-id__contacttable-department-entry}{#contact-GET-id__contacttable-edu_status-entry}{#contact-GET-id__contacttable-email-entry}{#contact-GET-id__contacttable-employee_number-entry}{#contact-GET-id__contacttable-enable_multifactor_authn-entry}{#contact-GET-id__contacttable-failed_attempts-entry}{#contact-GET-id__contacttable-first_name-entry}{#contact-GET-id__contacttable-gender-entry}{#contact-GET-id__contacttable-geolocation_tracked-entry}{#contact-GET-id__contacttable-home_phone-entry}{#contact-GET-id__contacttable-internal_integration_user-entry}{#contact-GET-id__contacttable-introduction-entry}{#contact-GET-id__contacttable-last_login-entry}{#contact-GET-id__contacttable-last_login_device-entry}{#contact-GET-id__contacttable-last_login_time-entry}{#contact-GET-id__contacttable-last_name-entry}{#contact-GET-id__contacttable-last_position_update-entry}{#contact-GET-id__contacttable-latitude-entry}{#contact-GET-id__contacttable-ldap_server-entry}{#contact-GET-id__contacttable-location-entry}{#contact-GET-id__contacttable-locked_out-entry}{#contact-GET-id__contacttable-longitude-entry}{#contact-GET-id__contacttable-manager-entry}{#contact-GET-id__contacttable-middle_name-entry}{#contact-GET-id__contacttable-mobile_phone-entry}{#contact-GET-id__contacttable-name-entry}{#contact-GET-id__contacttable-notification-entry}{#contact-GET-id__contacttable-on_schedule-entry}{#contact-GET-id__contacttable-phone-entry}{#contact-GET-id__contacttable-photo-entry}{#contact-GET-id__contacttable-preferred_language-entry}{#contact-GET-id__contacttable-roles-entry}{#contact-GET-id__contacttable-schedule-entry}{#contact-GET-id__contacttable-source-entry}{#contact-GET-id__contacttable-state-entry}{#contact-GET-id__contacttable-street-entry}{#contact-GET-id__contacttable-sys_class_name-entry}{#contact-GET-id__contacttable-sys_created_by-entry}{#contact-GET-id__contacttable-sys_created_on-entry}{#contact-GET-id__contacttable-sys_domain-entry}{#contact-GET-id__contacttable-sys_domain_path-entry}{#contact-GET-id__contacttable-sys_id-entry}{#contact-GET-id__contacttable-sys_mod_count-entry}{#contact-GET-id__contacttable-sys_updated_by-entry}{#contact-GET-id__contacttable-sys_updated_on-entry}{#contact-GET-id__contacttable-time_format-entry}{#contact-GET-id__contacttable-time_sheet_policy-entry}{#contact-GET-id__contacttable-time_zone-entry}{#contact-GET-id__contacttable-title-entry}{#contact-GET-id__contacttable-user_name-entry}{#contact-GET-id__contacttable-vip-entry}{#contact-GET-id__contacttable-web_service_access_only-entry}{#contact-GET-id__contacttable-zip-entry}

| Element | Beschreibung |
|-|-|
| Account | SYS_ID des Account-Datensatzes, dem der Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\] |
| aktiv | Kennzeichnung, die angibt, ob der Kontakt im System aktiv ist. Mögliche Werte: * Wahr: Kontakt ist aktiv * Falsch: Kontakt ist inaktiv Datentyp: Boolescher Wert Standard: Wahr |
| Agent_Status | Status des Service Desk-Mitarbeiters. Mögliche Werte: * Nicht in Arbeit * In Pause * Unterwegs * Am Standort Datentyp: Zeichenfolge Maximale Länge: 40 |
| Gebäude | SYS_ID des Datensatzes, der das Gebäude beschreibt, in dem sich der Kontakt befindet. Datentyp: Zeichenfolge Tabelle: Gebäude \[cmn_Building\] |
| Calendar_Integration | Kalenderanwendung, die der Kontakt verwendet. 1: Outlook Datentyp: Zahl (Ganzzahl) Standard: 1 |
| city | Stadt, in der sich der Kontakt befindet. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Unternehmen | SYS_ID des Unternehmensdatensatzes, dem der Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Unternehmen \[Core_Company\] |
| Kostenstelle | SYS_ID der Kostenstelle, die dem Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Kostenstelle \[cmn_Cost_Center\] |
| country | Ländercode des Landes, in dem der Kontakt ansässig ist. Datentyp: Zeichenfolge Maximale Länge: 3 |
| Datum_Format | Format, in dem Daten für Kontakte angezeigt werden sollen. Gültige Werte: * TT/MM/JJJJ * TT-MM-JJJJ * TT.MM.JJJJ * MM-TT-JJJJ * JJJJ-MM-TT Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Leer (Systemdatumsformat) |
| Default_perspective | SYS_ID der Standardperspektive für den Kontakt. Datentyp: Zeichenfolge Tabelle: Menüliste \[sys_perspective\] |
| department | SYS_ID der Abteilung, die dem Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Abteilung \[cmn_Department\] |
| edu_Status | Bildungsstatus des zugehörigen Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Fakultät |
| E-Mail | E-Mail-Adresse des Kontakts. Datentyp: Zeichenfolge |
| Employee_number | Kontaktmitarbeiternummer. Datentyp: Zeichenfolge |
| Enable_multifactor_authn | Kennzeichnung, die angibt, ob eine Multifaktor-Autorisierung erforderlich ist, damit sich der Kontakt beim Serviceportal anmeldet. Mögliche Werte: * Wahr: Multifaktor-Autorisierung aktiviert * Falsch: Multifaktor-Autorisierung deaktiviert Datentyp: Boolescher Wert Standard: Falsch |
| Failed_attempts | Anzahl der fehlgeschlagenen Anmeldeversuche. Datentyp: Zahl (Ganzzahl) |
| first_name | Vorname des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 50 |
| Geschlecht | Kontaktgeschlecht. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Positionsbestimmung_nachverfolgt | Kennzeichnung, die angibt, ob der Kontaktstandort über GeoTracking abgerufen wird. Mögliche Werte: * Wahr: Kontaktstandort durch GeoTracking abgerufen * Falsch: Kontaktstandort nicht durch GeoTracking abgerufen Datentyp: Boolescher Wert Standardwert: falsch |
| home_phone | Telefonnummer des Kontakts (privat). Datentyp: Zeichenfolge Maximale Länge: 40 |
| Internal_Integration_user | Kennzeichnung, die angibt, ob der Kontakt ein interner Integrationsanwender ist. Mögliche Werte: * Wahr: Interner Integrationsanwender * Falsch: Anderer Anwendertyp Datentyp: Boolescher Wert Standard: Falsch |
| Einführung | Einführung Datentyp: Zeichenfolge Maximale Länge: 40 |
| Last_login | Datum, an dem sich der Kontakt zuletzt beim System angemeldet hat. Datentyp: Zeichenfolge (Datum) |
| Last_login_device | Gerät, das der Verbraucher bei der letzten Anmeldung beim System verwendet hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Last_login_time | Datum und Uhrzeit der Anmeldung des Kontakts beim System. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| last_name | Nachname des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 50 |
| Last_Position_Update | Datum und Uhrzeit der letzten Aktualisierung der Position. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| latitude | Breitengradkoordinate des Kontakts. Datentyp: Zahl (Gleitkomma) Maximale Länge: 40 |
| ldap_Server | SYS_ID des LDAP-Servers, der vom Kontakt verwendet wurde, um sich zuletzt beim System anzumelden. Datentyp: Zeichenfolge Tabelle: LDAP-Server \[ldap_Server_config\] |
| location | SYS_ID des Datensatzes, der den Standort des Kontakts beschreibt Datentyp: Zeichenfolge Tabelle: Standort \[cmn_location\] |
| Gesperrt_out | Kennzeichnung, die angibt, ob der Kontakt gesperrt ist. Mögliche Werte: * Wahr: Kontakt gesperrt * Falsch: Kontakt nicht gesperrt Datentyp: Boolescher Wert Standard: Falsch |
| longitude | Längengradkoordinate des Kontakts. Datentyp: Zahl (Gleitkomma) Maximale Länge: 40 |
| Manager | SYS_ID des Datensatzes, der den direkten Vorgesetzten des Kontakts beschreibt. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Middle_Name | Zweiter Vorname des Kontakts. Datentyp: Zahl (Gleitkomma) Maximale Länge: 50 |
| mobile_phone | Mobiltelefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| name | Vollständiger Name des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 151 |
| Benachrichtigung | Gibt an, ob der Kontakt Benachrichtigungen erhalten soll. Gültige Werte: * 1: Deaktiviert * 2: Aktiviert Datentyp: Zahl (Ganzzahl) Standard: 2 |
| On_schedule | Gibt die Aktualität des entsandten Servicepersonals an. Gültige Werte: * Voraus: Vor dem Zeitplan. * Hinter_less30: Hinter Zeitplan, aber weniger als 30 Minuten. * Hinter_30to60: Hinter Zeitplan zwischen 30 und 60 Minuten. * Hinter_more60: Mehr als 60 Minuten hinter Zeitplan. * On_time: Im Zeitplan. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Telefon | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Foto | Foto des Kontakts. Datentyp: Zeichenfolge |
| Preferred_language | Ländercode der primären Sprache des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 3 |
| Rollen | Liste der Anwenderrollen, die dem Kontakt zugeordnet sind. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Zeitplan | SYS_ID des Datensatzes, der den Arbeitszeitplan für den zugehörigen Kontakt beschreibt. Datentyp: Zeichenfolge Tabelle: Zeitplan \[cmn_schedule\] |
| Quelle | Quelle des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Staat | Status, in dem sich der Kontakt befindet. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Straße | Straße und Hausnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| sys_class_name | Tabelle, die den Kontaktdatensatz enthält. Datentyp: Zeichenfolge Maximale Länge: 80 |
| sys_created_by | Anwender, der ursprünglich den zugehörigen Kontaktdatensatz erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_created_on | Daten und Uhrzeit der ursprünglichen Erstellung des zugehörigen Kontakts. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| sys_Domain | ServiceNow Instanzdomäne des zugehörigen Kontaktdatensatzes. Datentyp: Zeichenfolge |
| sys_Domain_path | Domänenpfad des Kontaktdatensatzes. Datentyp: Zeichenfolge Maximale Länge: 255 Standard: / (Global) |
| sys_id | Eindeutiger Bezeichner für den zugehörigen Kontaktdatensatz. Datentyp: Zeichenfolge |
| sys_mod_count | Gibt an, wie oft der zugeordnete Kontaktdatensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| sys_updated_by | Anwender, der die zugehörigen Kontaktinformationen zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_updated_on | Daten und Uhrzeit der Aktualisierung der zugehörigen Kontaktinformationen. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| Time_Format | Format, in dem die Zeit angezeigt werden soll. Gültige Werte: * hh.mm.ss A: hh.mm.ss (12 Stunden) * hh:mm:ss a: hh:mm:ss (12 Stunden) * HH.mm.ss: hh.mm.ss (24 Stunden) * HH:mm:ss: hh:mm:ss (24 Stunden) Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Leer (Systemzeitformat) |
| Time_sheet_Policy | SYS_ID des Datensatzes, der die Zeitnachweisrichtlinie für den zugehörigen Kontakt enthält. Datentyp: Zeichenfolge Tabelle: Zeitnachweisrichtlinie \[time_sheet_Policy\] |
| Time_Zone | Zeitzone, in der sich der Kontakt befindet, z. B. Kanada/Zentral oder USA/Ost. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Titel | Geschäftstitel des Kontakts, z. B. Manager, Softwareentwickler oder Auftragnehmer. Datentyp: Zeichenfolge Maximale Länge: 60 |
| user_name | Kontaktanwender-ID. Datentyp: Zeichenfolge Maximale Länge: 40 |
| vip | Kennzeichnung, die angibt, ob der zugeordnete Kontakt den VIP-Status hat. Mögliche Werte: * Wahr: VIP * Falsch: Nicht VIP Datentyp: Boolescher Wert Standard: Falsch |
| web_service_access_only | Kennzeichnung, die angibt, ob der Kontakt nur über das Web auf Services zugreifen kann. Mögliche Werte: * Wahr: Nur Webzugriff * Falsch: Zugriff über alle verfügbaren Methoden Datentyp: Boolescher Wert Standard: Falsch |
| Postleitzahl | Postleitzahl des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
[ ]

### Curl-Anforderung

    curl "https://instance.servicenow.com/api/now/contact/ddce70866f9331003b3c498f5d3ee417 \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    {
      "result": {
        "country": "",
        "calendar_integration": "1",
        "last_position_update": "",
        "last_login_time": "2018-03-10 21:48:11",
        "last_login_device": "",
        "source": "",
        "sys_updated_on": "2019-01-03 05:49:34",
        "building": "",
        "web_service_access_only": "false",
        "notification": "2",
        "sys_updated_by": "system",
        "enable_multifactor_authn": "false",
        "sys_created_on": "2018-03-04 20:26:32",
        "sys_domain": "global",
        "agent_status": "",
        "state": "",
        "vip": "false",
        "sys_created_by": "admin",
        "longitude": "",
        "zip": "",
        "home_phone": "",
        "time_format": "",
        "last_login": "",
        "default_perspective": "",
        "geolocation_tracked": "false",
        "active": "true",
        "time_sheet_policy": "",
        "sys_domain_path": "/",
        "phone": "+1 858 287 7834",
        "cost_center": "",
        "name": "George Warren",
        "employee_number": "",
        "gender": "",
        "city": "",
        "user_name": "george.warren",
        "failed_attempts": "",
        "edu_status": "",
        "latitude": "",
        "roles": "",
        "title": "Network Administrator",
        "sys_class_name": "customer_contact",
        "sys_id": "ddce70866f9331003b3c498f5d3ee417",
        "internal_integration_user": "false",
        "ldap_server": "",
        "mobile_phone": "+1 858 867 7857",
        "street": "",
        "company": "86837a386f0331003b3c498f5d3ee4ca",
        "department": "",
        "first_name": "George",
        "preferred_language": "",
        "introduction": "",
        "email": "geo.warren@mailinator.com",
        "manager": "",
        "locked_out": "false",
        "sys_mod_count": "3",
        "last_name": "Warren",
        "photo": "",
        "sys_tags": "",
        "middle_name": "",
        "time_zone": "",
        "schedule": "",
        "on_schedule": "",
        "date_format": "",
        "location": "25ab8e460a0a0bb300857304ff811af5",
        "account": "86837a386f0331003b3c498f5d3ee4ca"
      }
    }

## Kontakt: VERÖFFENTLICHEN SIE /now/contact {#ariaid-title4}

Erstellt eine neue Kundenservice-Management (CSM)Kontakt.
Darüber hinaus können Sie mit diesem Endpunkt ein Social Media-Profil für den Kontakt erstellen. Um das Profil zu erstellen, müssen Sie die folgenden Parameter im Anforderungstext angeben:

* social_channel
* social_handle
* social_handle_url
{#contact-POST__ul_ntx_lg4_pgb}  
Warnung:  
Dieser Endpunkt führt keine Parametervalidierung durch, da dies zu einem übermäßigen Overhead führen kann. Wenn ein Anforderungsparameter falsch geschrieben ist, ungültig ist oder vom Endpunkt nicht unterstützt wird, wird er ohne Warnung ignoriert.

### URL-Format

Versionierte URL: /api/now/{api_Version}/contact

Standard-URL: /api/now/contact  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#contact-POST__entry__2}{#contact-POST__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfad-Parameter]

{#contact-POST__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Abfrageparameter]

{#contact-POST__entry__10}{#contact-POST__contacttable-account-enrty}{#contact-POST__contacttable-active-entry}{#contact-POST__contacttable-agent_status-entry}{#contact-POST__contacttable-building-entry}{#contact-POST__contacttable-calendar_integration-entry}{#contact-POST__contacttable-city-entry}{#contact-POST__contacttable-company-entry}{#contact-POST__contacttable-cost_center-entry}{#contact-POST__contacttable-country-entry}{#contact-POST__contacttable-date_format-entry}{#contact-POST__contacttable-default_perspective-entry}{#contact-POST__contacttable-department-entry}{#contact-POST__contacttable-edu_status-entry}{#contact-POST__contacttable-email-entry}{#contact-POST__contacttable-employee_number-entry}{#contact-POST__contacttable-enable_multifactor_authn-entry}{#contact-POST__contacttable-failed_attempts-entry}{#contact-POST__contacttable-first_name-entry}{#contact-POST__contacttable-gender-entry}{#contact-POST__contacttable-geolocation_tracked-entry}{#contact-POST__contacttable-home_phone-entry}{#contact-POST__contacttable-internal_integration_user-entry}{#contact-POST__contacttable-introduction-entry}{#contact-POST__contacttable-last_login_device-entry}{#contact-POST__contacttable-last_login_time-entry}{#contact-POST__contacttable-last_name-entry}{#contact-POST__contacttable-latitude-entry}{#contact-POST__contacttable-ldap_server-entry}{#contact-POST__contacttable-location-entry}{#contact-POST__contacttable-locked_out-entry}{#contact-POST__contacttable-longitude-entry}{#contact-POST__contacttable-manager-entry}{#contact-POST__contacttable-middle_name-entry}{#contact-POST__contacttable-mobile_phone-entry}{#contact-POST__contacttable-name-entry}{#contact-POST__contacttable-notification-entry}{#contact-POST__contacttable-on_schedule-entry}{#contact-POST__contacttable-phone-entry}{#contact-POST__contacttable-photo-entry}{#contact-POST__contacttable-preferred_language-entry}{#contact-POST__contacttable-roles-entry}{#contact-POST__contacttable-schedule-entry}{#contact-POST__contacttable-source-entry}{#contact-POST__contacttable-state-entry}{#contact-POST__contacttable-street-entry}{#contact-POST__contacttable-time_format-entry}{#contact-POST__contacttable-time_sheet_policy-entry}{#contact-POST__contacttable-time_zone-entry}{#contact-POST__contacttable-title-entry}{#contact-POST__contacttable-user_name-entry}{#contact-POST__contacttable-vip-entry}{#contact-POST__contacttable-web_service_access_only-entry}{#contact-POST__contacttable-zip-entry}

| Element | Beschreibung |
|-|-|
| Account | SYS_ID des Account-Datensatzes, dem der Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\] |
| aktiv | Kennzeichnung, die angibt, ob der Kontakt im System aktiv ist. Mögliche Werte: * Wahr: Kontakt ist aktiv * Falsch: Kontakt ist inaktiv Datentyp: Boolescher Wert Standard: Wahr |
| Agent_Status | Status des Service Desk-Mitarbeiters. Mögliche Werte: * Nicht in Arbeit * In Pause * Unterwegs * Am Standort Datentyp: Zeichenfolge Maximale Länge: 40 |
| Gebäude | SYS_ID des Datensatzes, der das Gebäude beschreibt, in dem sich der Kontakt befindet. Datentyp: Zeichenfolge Tabelle: Gebäude \[cmn_Building\] |
| Calendar_Integration | Kalenderanwendung, die der Kontakt verwendet. 1: Outlook Datentyp: Zahl (Ganzzahl) Standard: 1 |
| city | Stadt, in der sich der Kontakt befindet. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Unternehmen | SYS_ID des Unternehmensdatensatzes, dem der Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Unternehmen \[Core_Company\] |
| Kostenstelle | SYS_ID der Kostenstelle, die dem Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Kostenstelle \[cmn_Cost_Center\] |
| country | Ländercode des Landes, in dem der Kontakt ansässig ist. Datentyp: Zeichenfolge Maximale Länge: 3 |
| Datum_Format | Format, in dem Daten für Kontakte angezeigt werden sollen. Gültige Werte: * TT/MM/JJJJ * TT-MM-JJJJ * TT.MM.JJJJ * MM-TT-JJJJ * JJJJ-MM-TT Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Leer (Systemdatumsformat) |
| Default_perspective | SYS_ID der Standardperspektive für den Kontakt. Datentyp: Zeichenfolge Tabelle: Menüliste \[sys_perspective\] |
| department | SYS_ID der Abteilung, die dem Kontakt zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Abteilung \[cmn_Department\] |
| edu_Status | Bildungsstatus des zugehörigen Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Fakultät |
| E-Mail | E-Mail-Adresse des Kontakts. Datentyp: Zeichenfolge |
| Employee_number | Kontaktmitarbeiternummer. Datentyp: Zeichenfolge |
| Enable_multifactor_authn | Kennzeichnung, die angibt, ob eine Multifaktor-Autorisierung erforderlich ist, damit sich der Kontakt beim Serviceportal anmeldet. Mögliche Werte: * Wahr: Multifaktor-Autorisierung aktiviert * Falsch: Multifaktor-Autorisierung deaktiviert Datentyp: Boolescher Wert Standard: Falsch |
| Failed_attempts | Anzahl der fehlgeschlagenen Anmeldeversuche. Datentyp: Zahl (Ganzzahl) |
| first_name | Vorname des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 50 |
| Geschlecht | Kontaktgeschlecht. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Positionsbestimmung_nachverfolgt | Kennzeichnung, die angibt, ob der Kontaktstandort über GeoTracking abgerufen wird. Mögliche Werte: * Wahr: Kontaktstandort durch GeoTracking abgerufen * Falsch: Kontaktstandort nicht durch GeoTracking abgerufen Datentyp: Boolescher Wert Standardwert: falsch |
| home_phone | Telefonnummer des Kontakts (privat). Datentyp: Zeichenfolge Maximale Länge: 40 |
| Internal_Integration_user | Kennzeichnung, die angibt, ob der Kontakt ein interner Integrationsanwender ist. Mögliche Werte: * Wahr: Interner Integrationsanwender * Falsch: Anderer Anwendertyp Datentyp: Boolescher Wert Standard: Falsch |
| Einführung | Einführung Datentyp: Zeichenfolge Maximale Länge: 40 |
| Last_login_device | Gerät, das der Verbraucher bei der letzten Anmeldung beim System verwendet hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Last_login_time | Datum und Uhrzeit der Anmeldung des Kontakts beim System. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| last_name | Nachname des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 50 |
| latitude | Breitengradkoordinate des Kontakts. Datentyp: Zahl (Gleitkomma) Maximale Länge: 40 |
| ldap_Server | SYS_ID des LDAP-Servers, der vom Kontakt verwendet wurde, um sich zuletzt beim System anzumelden. Datentyp: Zeichenfolge Tabelle: LDAP-Server \[ldap_Server_config\] |
| location | SYS_ID des Datensatzes, der den Standort des Kontakts beschreibt Datentyp: Zeichenfolge Tabelle: Standort \[cmn_location\] |
| Gesperrt_out | Kennzeichnung, die angibt, ob der Kontakt gesperrt ist. Mögliche Werte: * Wahr: Kontakt gesperrt * Falsch: Kontakt nicht gesperrt Datentyp: Boolescher Wert Standard: Falsch |
| longitude | Längengradkoordinate des Kontakts. Datentyp: Zahl (Gleitkomma) Maximale Länge: 40 |
| Manager | SYS_ID des Datensatzes, der den direkten Vorgesetzten des Kontakts beschreibt. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Middle_Name | Zweiter Vorname des Kontakts. Datentyp: Zahl (Gleitkomma) Maximale Länge: 50 |
| mobile_phone | Mobiltelefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| name | Vollständiger Name des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 151 |
| Benachrichtigung | Gibt an, ob der Kontakt Benachrichtigungen erhalten soll. Gültige Werte: * 1: Deaktiviert * 2: Aktiviert Datentyp: Zahl (Ganzzahl) Standard: 2 |
| On_schedule | Gibt die Aktualität des entsandten Servicepersonals an. Gültige Werte: * Voraus: Vor dem Zeitplan. * Hinter_less30: Hinter Zeitplan, aber weniger als 30 Minuten. * Hinter_30to60: Hinter Zeitplan zwischen 30 und 60 Minuten. * Hinter_more60: Mehr als 60 Minuten hinter Zeitplan. * On_time: Im Zeitplan. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Telefon | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Foto | Foto des Kontakts. Datentyp: Zeichenfolge |
| Preferred_language | Ländercode der primären Sprache des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 3 |
| Rollen | Liste der Anwenderrollen, die dem Kontakt zugeordnet sind. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Zeitplan | SYS_ID des Datensatzes, der den Arbeitszeitplan für den zugehörigen Kontakt beschreibt. Datentyp: Zeichenfolge Tabelle: Zeitplan \[cmn_schedule\] |
| Social_Channel | Social Media-Kanal, dem der Kontakt zugeordnet ist, z. B. Twitter, Facebook oder Instagram. Datentyp: Zeichenfolge |
| Social_Handle | Anwender-Handle im Social Media-Kanal. Datentyp: Zeichenfolge |
| Social_Handle_url | URL zum Profil des sozialen Kanals des Kontakts. Datentyp: Zeichenfolge |
| Quelle | Quelle des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Staat | Status, in dem sich der Kontakt befindet. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Straße | Straße und Hausnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Time_Format | Format, in dem die Zeit angezeigt werden soll. Gültige Werte: * hh.mm.ss A: hh.mm.ss (12 Stunden) * hh:mm:ss a: hh:mm:ss (12 Stunden) * HH.mm.ss: hh.mm.ss (24 Stunden) * HH:mm:ss: hh:mm:ss (24 Stunden) Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Leer (Systemzeitformat) |
| Time_sheet_Policy | SYS_ID des Datensatzes, der die Zeitnachweisrichtlinie für den zugehörigen Kontakt enthält. Datentyp: Zeichenfolge Tabelle: Zeitnachweisrichtlinie \[time_sheet_Policy\] |
| Time_Zone | Zeitzone, in der sich der Kontakt befindet, z. B. Kanada/Zentral oder USA/Ost. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Titel | Geschäftstitel des Kontakts, z. B. Manager, Softwareentwickler oder Auftragnehmer. Datentyp: Zeichenfolge Maximale Länge: 60 |
| user_name | Kontaktanwender-ID. Datentyp: Zeichenfolge Maximale Länge: 40 |
| vip | Kennzeichnung, die angibt, ob der zugeordnete Kontakt den VIP-Status hat. Mögliche Werte: * Wahr: VIP * Falsch: Nicht VIP Datentyp: Boolescher Wert Standard: Falsch |
| web_service_access_only | Kennzeichnung, die angibt, ob der Kontakt nur über das Web auf Services zugreifen kann. Mögliche Werte: * Wahr: Nur Webzugriff * Falsch: Zugriff über alle verfügbaren Methoden Datentyp: Boolescher Wert Standard: Falsch |
| Postleitzahl | Postleitzahl des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
[Tabelle : 15. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#contact-POST__entry__124}{#contact-POST__accept-JSON-only-entry-RESTAPI}{#contact-POST__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 16. Anforderungskopfzeilen.]

{#contact-POST__entry__130}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#contact-POST__entry__134}{#contact-POST__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 201 | Neuer Kontaktdatensatz wurde erfolgreich erstellt. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim serverseitigen Code ist ein Logikfehler aufgetreten. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#contact-POST__entry__144}

| Element | Beschreibung |
|-|-|
| Ergebnis | SYS_ID des neu erstellten Kontaktdatensatzes. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

    curl -X POST "https://instance.servicenow.com/api/now/contact" \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json' \
    -d '{ \
      "country": "USA", \
      "calendar_integration": "1", \
      "last_login_time": "2018-03-10 21:48:11", \
      "last_login_device": "tablet", \
      "building": "Cardinal West", \
      "web_service_access_only": "false", \
      "notification": "1", \
      "enable_multifactor_authn": "true", \
      "agent_status": "Travelling", \
      "state": "CA", \
      "vip": "false", \
      "longitude": "123.76", \
      "zip": "92069", \
      "home_phone": "(555)555-1234", \
      "time_format": "hh:mm:ss", \
      "geolocation_tracked": "false", \
      "active": "true", \
      "phone": "+1 858 287 7834", \
      "cost_center": "1345", \
      "name": "Dora Warren", \
      "employee_number": "546", \
      "gender": "Female", \
      "city": "Orlando", \
      "user_name": "dora.warren", \
      "failed_attempts": "2", \
      "edu_status": "current", \
      "latitude": "57.6", \
      "title": "Network Administrator", \
      "internal_integration_user": "false", \
      "ldap_server": "10.24.23.123", \
      "mobile_phone": "+1 858 867 7857", \
      "street": "123 Lagume", \
      "company": "86837a386f0331003b3c498f5d3ee4ca", \
      "department": "IT", \
      "first_name": "Dora", \
      "preferred_language": "Spanish", \
      "email": "dora.warren@mailinator.com", \
      "manager": "ddce70866f9331003b3c498f5d3ee417", \
      "locked_out": "false", \
      "last_name": "Warren", \
      "middle_name": "Dell", \
      "time_zone": "PST", \
      "schedule": "9-5", \
      "date_format": "MM/DD/YY", \
      "location": "25ab8e460a0a0bb300857304ff811af5", \
      "account": "86837a386f0331003b3c498f5d3ee4ca" \
    }'
    --user 'username':'password'

    "result": "62fe1c97db76c3006b7a9646db961999"


