---
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


---

# Lead-API

# Lead-API {#ariaid-title1}

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

Die Lead Die API bietet Endpunkte, mit denen Sie Marketing-Leads und die zugehörigen Lead-Positionselemente aus einer Instanz erstellen, aktualisieren und abfragen/abrufen können.
Verwenden Sie diese API, um Ihre Instanz in externe Websites und Systeme wie automatisierte Lead-Erfassungssysteme zu integrieren oder Lead-Informationen für externe Reporting-Systeme bereitzustellen.

Diese API wird in bereitgestellt `sn_lead_mgmt_core `Namespace. Um auf die API zuzugreifen, muss das Plugin „Lead-Management-Datenmodell" (sn_lead_mgmt_core) in der Instanz aktiviert sein, und der aufrufende Anwender muss über die sn_lead_mgmt_core.lead_integrator-Rolle verfügen.

Für zusätzliche Informationen zu Lead Management, Siehe [Using Lead Management](https://www.servicenow.com/docs/access?context=lead-management-using&version=yokohama&pubname=yokohama-order-management&ft:locale=en-US).

## Lead-API wird erweitert {#lead-api__section_ntp_vvc_tdc}

Sie können erweitern Lead API durch Überschreiben der Methoden in den zugehörigen Skripteinbindungen. Die Standard-API-Funktionalität befindet sich in Skripteinbindungen, die auf „OOB" enden, z. B. LeadAPIProcessUtilOOB . Um diese Funktionalität zu überschreiben, erstellen Sie Methoden mit identischen Namen und Parametern in der Skripteinbindung, die denselben Dateinamen haben, aber nicht auf „OOB" enden, z. B. LeadAPIProzessUtil .

Im Folgenden finden Sie eine Liste der Skripteinbindungen, die Sie überschreiben können, um das Verhalten von zu ändern Lead API:  
* [LeadAPIProcessUtilOOB](https://servicenow-prod.fluidtopics.net/r2e_CDxCDRuFjLZK_suYjw#LeadAPIProcessUtilOOBAPI "Die LeadAPIProcessUtilOOB Die Skripteinbindung stellt Methoden bereit, die von aufgerufen werden Lead REST-API zum Abrufen von Lead-Datensätzen und den zugehörigen Lead-Positionselementdatensätzen."): Enthält Methoden, die den Abruf und die Erstellung von Lead- und Lead-Positionselementdatensätzen verarbeiten.
* [LeadApiValidationUtilOOB](https://servicenow-prod.fluidtopics.net/pBl1ez~yVPvJlvqhRJA_Kw#LeadAPIValidationUtilOOBAPI "Die LeadAPIValidationUtilOOB Die Skripteinbindung stellt Methoden bereit, die von aufgerufen werden Lead REST-API zum Validieren von Lead-Datensätzen und zugehörigen Lead-Positionselementdatensätzen, wenn sie erstellt (POST) oder aktualisiert (PATCH) werden."): Enthält Methoden, die das JSON-Anforderungsobjekt für die POST- und PATCH-Endpunkte validieren.
* [LeadAPIHelperOOB](https://servicenow-prod.fluidtopics.net/kqtVjwtgjccCWvDFIXMDvw#LeadAPIHelperOOBAPI "Die LeadAPIHelperOOB Die Skripteinbindung stellt Hilfsmethoden bereit, die von aufgerufen werden Lead REST-API zum Ausführen verschiedener Funktionen, z. B. zum Konvertieren einer Reihe von Lead-Datensätzen aus einem GlideRecord-Objekt in ein JSON-Array oder JSON-Objekt und zum Transformieren von Feldern innerhalb eines Lead-Objekts."): Enthält API-Hilfsmethoden, die:
  * Gibt ein Array von Leads und zugehörigen Lead-Positionselementen zurück.
  * Gibt ein JSON-Objekt aus dem zugehörigen GlideRecord zurück.
  * Entfernen Sie alle ignorierten Felder aus einem JSON-Objekt, und führen Sie andere Transformationen durch.
* LeadAPIKonstantenOOB : Enthält Konstanten, Statuscodes und Nachrichten für alle API-Vorgänge. Es enthält auch die Liste der Felder, die von den POST- und PATCH-Endpunkten ignoriert werden.

## Lead: RUFT /sn_lead_mgmt_core/Lead AB {#ariaid-title2}

Ruft alle Leads und zugehörigen Lead-Positionselemente basierend auf den in den Abfrageparametern übergebenen Filterkriterien ab.
Dieser Endpunkt gibt eine paginierte Antwort gemäß dem angegebenen Grenzwert und dem angegebenen Offset zurück. Ruft Informationen aus den folgenden Tabellen ab:

* Lead \[sn_lead_mgmt_core_lead\]
* Lead-Positionselement \[sn_lead_mgmt_core_lead_line_item\]
{#lead-GET-lead__ul_n5f_xzn_sdc}

### URL-Format

Versionierte URL: /api/sn_lead_mgmt_core/{api_Version}/Lead

Standard-URL: /api/sn_lead_mgmt_core/{api_Version}/Lead  
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

{#lead-GET-lead__entry__2}{#lead-GET-lead__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]

{#lead-GET-lead__entry__6}{#lead-GET-lead__sysparm_fields_entry-RESTAPI}{#lead-GET-lead__sysparm-limit-RESTAPI}{#lead-GET-lead__sysparm_offset-ph-RESTAPI}

| Name | Beschreibung |
|-|-|
| Sysparm_fields | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben. |
| 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. Dieser Grenzwert wird vor der ACL-Auswertung angewendet. Wenn keine Datensätze zurückgegeben werden, einschließlich der Datensätze, auf die Sie Zugriff haben, ordnen Sie die Datensatzreihenfolge so an, dass Datensätze, auf die Sie zuerst zugreifen können, zurückgegeben werden. Hinweis: Ungewöhnlich groß sysparm_limitWerte können sich auf die Systemleistung auswirken. Datentyp: Zahl Standard: 20 Maximum: 100 |
| 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.{#lead-GET-lead__sysparm_offset-p-RESTAPI} Ü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]

{#lead-GET-lead__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter]

### 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.").
{#lead-GET-lead__entry__20}{#lead-GET-lead__content_type-JSON-only-entry-RESTAPI}

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

{#lead-GET-lead__entry__24}{#lead-GET-lead__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltsbereich | Inhaltsbereich, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn Offset=2 und Limit=3, ist der Wert des Inhaltsbereichs-Headers die Elemente 3--5. |
| Links | Links zum Navigieren in den Abfrageergebnissen: * zuerst * letzte * Weiter * previous * Selbst |
| Gesamtanzahl | Gesamtanzahl der gefilterten Datensätze. |
[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.").
{#lead-GET-lead__entry__34}{#lead-GET-lead__entry-200-status-code}{#lead-GET-lead__entry-404-status-code}{#lead-GET-lead__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Anforderung wurde erfolgreich verarbeitet. Alle Antworten zurückgegeben (keine Paginierung). |
| 206 | Anforderung erfolgreich verarbeitet. In Antwort zurückgegebene Teilressource (mit Paginierung). |
| 400 | Fehler. Mögliche Gründe: * Ungültiger Grenzwert/Grenzwert größer als zulässig. * Ungültiger Offset. |
| 403 | Datensatz hat Zugriff verweigert. Unzureichende Berechtigung zum Abfragen des Datensatzes. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter

{#lead-GET-lead__entry__48}{#lead-GET-lead__lead-account-entry}{#lead-GET-lead__lead-account.name-entry}{#lead-GET-lead__lead-account.sys_id-entry}{#lead-GET-lead__lead-business_phone-entry}{#lead-GET-lead__lead-city-entry}{#lead-GET-lead__lead-closed_date-ph}{#lead-GET-lead__lead-closed_date.display_value-entry}{#lead-GET-lead__lead-closed_date.value-entry}{#lead-GET-lead__lead-company-entry}{#lead-GET-lead__lead-consumer-ph}{#lead-GET-lead__lead-consumer.name-entry}{#lead-GET-lead__lead-consumer.sys_id-entry}{#lead-GET-lead__lead-contact-ph}{#lead-GET-lead__lead-contact.name-entry}{#lead-GET-lead__lead-contact.sys_id-entry}{#lead-GET-lead__lead-country-entry}{#lead-GET-lead__lead-do_not_call-entry}{#lead-GET-lead__lead-do_not_email-entry}{#lead-GET-lead__lead-do_not_share-entry}{#lead-GET-lead__lead-email-entry}{#lead-GET-lead__lead-external_id-entry}{#lead-GET-lead__lead-external_system-entry}{#lead-GET-lead__lead-first_name-entry}{#lead-GET-lead__lead-industry-entry}{#lead-GET-lead__lead-last_name-entry}{#lead-GET-lead__lead-lead_group-entry}{#lead-GET-lead__lead-lead_group.name-entry}{#lead-GET-lead__lead-lead_group.sys_id-entry}{#lead-GET-lead__lead-lead_line_items-entry}{#lead-GET-lead__lead-lead_line_items.external_id-entry}{#lead-GET-lead__lead-lead_line_items.external_system-entry}{#lead-GET-lead__lead-lead_line_items.lead-entry}{#lead-GET-lead__lead-lead_line_items.lead.name-entry}{#lead-GET-lead__lead-lead_line_items.lead.sys_id-entry}{#lead-GET-lead__lead-lead_line_items.number-entry}{#lead-GET-lead__lead-lead_line_items.product_offering-ph}{#lead-GET-lead__lead-lead_line_items.product_offering.code-entry}{#lead-GET-lead__lead-lead_line_items.product_offering.name-entry}{#lead-GET-lead__lead-lead_line_items.product_offering.sys_id-entry}{#lead-GET-lead__lead-lead_line_items.quantity-entry}{#lead-GET-lead__lead-lead_line_items.sys_created_by-entry}{#lead-GET-lead__lead-lead_line_items.sys_created_on-entry}{#lead-GET-lead__lead-lead_line_items.sys_created_on.display_value-entry}{#lead-GET-lead__lead-lead_line_items.sys_created_on.value-entry}{#lead-GET-lead__lead-lead_line_items.sys_domain-entry}{#lead-GET-lead__lead-lead_line_items.sys_domain_path-entry}{#lead-GET-lead__lead-lead_line_items.sys_id-entry}{#lead-GET-lead__lead-lead_line_items.sys_mod_count-entry}{#lead-GET-lead__lead-lead_line_items.sys_tags-entry}{#lead-GET-lead__lead-lead_line_items.sys_updated_by-entry}{#lead-GET-lead__lead-lead_line_items.sys_updated_on-entry}{#lead-GET-lead__lead-lead_line_items.sys_updated_on.display_value-entry}{#lead-GET-lead__lead-lead_line_items.sys_updated_on.value-entry}{#lead-GET-lead__lead-lead_line_items.unit_of_measurement-entry}{#lead-GET-lead__lead-lead_line_items.unit_of_measurement.name-entry}{#lead-GET-lead__lead-lead_line_items.unit_of_measurement.sys_id-entry}{#lead-GET-lead__lead-lead_line_items.work_notes-entry}{#lead-GET-lead__lead-lead_line_items.work_notes.author-entry}{#lead-GET-lead__lead-lead_line_items.work_notes.date-entry}{#lead-GET-lead__lead-lead_line_items.work_notes.text-entry}{#lead-GET-lead__lead-lead_rating-entry}{#lead-GET-lead__lead-lead_score-entry}{#lead-GET-lead__lead-lead_source-entry}{#lead-GET-lead__lead-lead_type-entry}{#lead-GET-lead__lead-middle_name-entry}{#lead-GET-lead__lead-mobile_phone-entry}{#lead-GET-lead__lead-number-entry}{#lead-GET-lead__lead-other_reason-entry}{#lead-GET-lead__lead-owner-entry}{#lead-GET-lead__lead-owner.name-entry}{#lead-GET-lead__lead-owner.sys_id-entry}{#lead-GET-lead__lead-reason-entry}{#lead-GET-lead__lead-short_description-entry}{#lead-GET-lead__lead-similar_lead-entry}{#lead-GET-lead__lead-similar_lead.name-entry}{#lead-GET-lead__lead-similar_lead.sys_id-entry}{#lead-GET-lead__lead-stage-entry}{#lead-GET-lead__lead-state-entry}{#lead-GET-lead__lead-street-entry}{#lead-GET-lead__lead-sys_class_name-entry}{#lead-GET-lead__lead-sys_created_by-entry}{#lead-GET-lead__lead-sys_created_on-entry}{#lead-GET-lead__lead-sys_created_on.display_value-entry}{#lead-GET-lead__lead-sys_created_on.value-entry}{#lead-GET-lead__lead-sys_domain-entry}{#lead-GET-lead__lead-sys_domain_path-entry}{#lead-GET-lead__lead-sys_id-entry}{#lead-GET-lead__lead-sys_mod_count-entry}{#lead-GET-lead__lead-sys_tags-entry}{#lead-GET-lead__lead-sys_updated_by-entry}{#lead-GET-lead__lead-sys_updated_on-entry}{#lead-GET-lead__lead-sys_updated_on.display_value-entry}{#lead-GET-lead__lead-sys_updated_on.value-entry}{#lead-GET-lead__lead-title-entry}{#lead-GET-lead__lead-website-entry}{#lead-GET-lead__lead-work_notes-entry}{#lead-GET-lead__lead-work_notes.author-entry}{#lead-GET-lead__lead-work_notes.date-entry}{#lead-GET-lead__lead-work_notes.text-entry}{#lead-GET-lead__lead-zip-entry}

| Name | Beschreibung |
|-|-|
| Account | Account, der mit dem Lead verknüpft ist. Datentyp: Objekt "account": { "name": "String", "sys_id": "String" } |
| account.name | Name des Accounts. Datentyp: Zeichenfolge |
| Account.sys_ID | SYS_ID des zugeordneten Account-Datensatzes. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\] |
| business_phone | Geschäftliche Telefonnummer des Leads. Datentyp: Zeichenfolge |
| city | Stadt, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| Closed_date | Datum und Uhrzeit der Schließung des Leads. Datentyp: Objekt "closed_date": { "display_value": "String", "value": "String" } |
| Closed_date. ​Display_value | Datum und Uhrzeit wie in der Anwenderoberfläche angezeigt. Datentyp: Zeichenfolge Format: Format und Zeitzone des Anwenders. |
| Closed_date.value | Datum und Uhrzeit, zu der der Lead geschlossen wurde, wie im zugehörigen Datensatz definiert. Datentyp: Zeichenfolge Format: UTC |
| Unternehmen | Unternehmensname des Leads. Datentyp: Zeichenfolge |
| consumer | Verbraucher, der dem Lead zugeordnet ist. Datentyp: Objekt "consumer": { "name": "String", "sys_id": "String" } |
| consumer.name | Name des zugeordneten Verbrauchers. Datentyp: Zeichenfolge |
| Consumer.sys_ID | SYS_ID des zugeordneten Verbraucherdatensatzes. Datentyp: Zeichenfolge Tabelle: Verbraucher \[csm_Consumer\] |
| Kontakt | Kontakt, der dem Lead-Account zugeordnet ist. Datentyp: Objekt "contact": { "name": "String", "sys_id": "String" } |
| contact.name | Name des Kontakts. Datentyp: Zeichenfolge |
| Contact.sys_ID | SYS_ID des zugeordneten Kontaktdatensatzes. Datentyp: Zeichenfolge Tabelle: Kontakt \[Customer_contact\] |
| country | Land, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Do_Not_Call | Kennzeichnung, die angibt, ob der Kommunikationsmodus per Telefon erfolgt. Gültige Werte: * Wahr: Kann Kontakt anrufen. * Falsch: Kontakt nicht anrufen. Datentyp: Boolescher Wert |
| Do_Not_email | Kennzeichnung, die angibt, ob der Kommunikationsmodus per E-Mail erfolgt. Gültige Werte: * Wahr: Kann Kontakt per E-Mail senden. * Falsch: Senden Sie keine E-Mail an den Kontakt. Datentyp: Boolescher Wert |
| Nicht_freigeben | Kennzeichnung, die angibt, ob die Lead-Details freigegeben werden können. Gültige Werte: * Wahr: Lead-Details können freigegeben werden. * Falsch: Lead-Details können nicht geteilt werden. Datentyp: Boolescher Wert |
| E-Mail | E-Mail-Adresse des Leads. Datentyp: Zeichenfolge |
| external_id | ID, die vom System verwendet wird, das den Lead generiert hat, um den Lead im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| External_System | Name des externen Systems, das dem Lead zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| first_name | Vorname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Branche | Branche, zu der der Lead gehört. Datentyp: Zeichenfolge Tabelle: Befindet sich in industryFeld der Account-Tabelle \[Customer_Account\]. |
| last_name | Nachname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Lead_Group | Gruppe, zu der der Lead gehört. Datentyp: Objekt "lead_group": { "name: "String", "sys_id": "String" } |
| lead_group.name | Name der Lead-Gruppe. Datentyp: Zeichenfolge |
| Lead_Group.sys_ID | SYS_ID des Lead-Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| Lead_line_items | Details der Lead-Positionselemente, die dem Lead zugeordnet sind. Datentyp: Array von Objekten "lead_line_items": [ { "external_id": "String", "external_system": "String", "lead": {Object}, "number": "String", "product_offering": {Object}, "quantity": Number, "sys_created_by": "String", "sys_created_on {Object}, "sys_domain": "String", "sys_domain_path": "String", "sys_id": "String", "sys_mod_count": Number, "sys_tags": [Array], "sys_updated_by: "String", "sys_updated_on: {Object}, "unit_of_measurement": {Object}, "work_notes": [Array] } ] |
| Lead_line_items. ​External_ID | ID, die vom System verwendet wird, das die Lead-Position generiert hat, um die Position im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| Lead_line_items. ​External_System | Name des externen Systems, das dem Lead-Positionselement zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| Lead_line_items. ​Lead | Details zum Lead, der der Position zugeordnet ist. Datentyp: Objekt "lead: { "name": "String", "sys_id": "String" } |
| Lead_line_items. ​lead.name | Name des zugeordneten Leads. Datentyp: Zeichenfolge |
| Lead_line_items. ​Lead.sys_ID | SYS_ID des zugeordneten Lead-Datensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​Nummer | Eindeutige vom System generierte Nummer des Lead-Positionselementdatensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​Product_Offering | Informationen zum Produktangebot, das der Lead-Position zugeordnet ist. Datentyp: Objekt "product_offering": { "code": " String", "name": "String", "sys_id": "String" } |
| Lead_line_items. ​Product_offering.Code | Code, der mit dem Produktangebot verknüpft ist. Hinweis: Dies ist eine vom System generierte alphanumerische Nummer basierend auf dem Produktnamen. Obwohl vom System generiert, können Sie den Code bearbeiten, um eine SKU oder andere branchenspezifische Produktcodes darzustellen. Datentyp: Zeichenfolge |
| Lead_line_items. ​product_offering.name | Name des Produktangebots. Datentyp: Zeichenfolge |
| Lead_line_items. ​Product_Offering.sys_ID | SYS_ID des Produktangebotsdatensatzes, der der Lead-Position zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| Lead_line_items. ​Menge | Menge der Artikel, die der Lead des zugehörigen Produktangebots kaufen möchte. Datentyp: Zahl (Ganzzahl) |
| Lead_line_items. ​sys_created_by | Anwendername der Person, die die Lead-Position erstellt hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_created_on | Vom System generiertes Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| Lead_line_items. ​sys_created_on.display_value | Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| Lead_line_items. ​sys_created_on.value | Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Zeichenfolge Format: UTC |
| Lead_line_items. ​sys_Domain | SYS_ID des Domänendatensatzes, zu dem das Lead-Positionselement gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| lead_line_items.sys_domain_path | Pfad der Domäne, zu der das Lead-Positionselement gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_ID | SYS_ID des Lead-Positionselementdatensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_mod_count | Gibt an, wie oft der zugehörige Lead-Positionselementdatensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| Lead_line_items. ​sys_Tags | Liste der System-Tags, die dem Lead-Positionselement zugeordnet sind. Datentyp: Array |
| Lead_line_items. ​sys_updated_by | Anwendername der Person, die die zugehörige Lead-Position zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_updated_on | Vom System generiertes Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| Lead_line_items. ​sys_updated_on. ​Display_value | Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| Lead_line_items. ​sys_updated_on. ​Wert | Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Zeichenfolge Format: UTC |
| Lead_line_items. ​Unit_of_Measurement | Details der Maßeinheit des Lead-Positionselements. Datentyp: Objekt "unit_of_measurement": { "name": "String", "sys_id": "String" } |
| Lead_line_items. ​Unit_of_Measurement. ​Name | Name der Maßeinheit, z. B. „einzeln" oder „Kubikfuß". Datentyp: Zeichenfolge |
| Lead_line_items. ​Unit_of_Measurement. ​sys_ID | SYS_ID des Datensatzes, der die Maßeinheit beschreibt. Datentyp: Zeichenfolge Tabelle: Maßeinheit \[sn_prd_pm_uom\] |
| Lead_line_items. ​Work_Notes | Liste, die die für die Lead-Position erstellten Arbeitsnotizen beschreibt. Datentyp: Array von Objekten "work_notes": [ { "author": "String", "date": "String", "text": "String" } ] |
| Lead_line_items. ​Work_Notes. ​Autor | Anwendername der Person, die die zugehörige Arbeitsnotiz erstellt hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​Work_Notes. ​Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Lead_line_items. ​Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Lead_Rating | Bewertung für den Lead, z. B. 100_kalt, 200_warm, 300_hot oder 400_super_hot. Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_Rating" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_Score | Punktzahl für den Lead. Datentyp: Decimal Bereich: 1 bis 100 |
| Lead_Source | Urheber des Leads. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Feld „Lead_Source" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_type | Typ des Leads, z. B. „Neues Geschäft" oder „vorhandenes Geschäft". Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_type" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Middle_Name | Zweiter Vorname des Kontakts für den Lead. Datentyp: Zeichenfolge |
| mobile_phone | Telefonnummer des Kontakts für den Lead. Datentyp: Zeichenfolge |
| Nummer | Eindeutige vom System generierte Nummer des Lead-Datensatzes. Datentyp: Zeichenfolge |
| Other_reason | Zusätzlicher Grund für die Lead-Disqualifizierung. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Eigentümer | Details der Person, die dem Lead zugeordnet ist. Datentyp: Objekt "owner": { "name": "String", "sys_id": "String" } |
| owner.name | Name der Person, die den Lead besitzt. Datentyp: Zeichenfolge |
| Besitzer.sys_ID | SYS_ID des Anwenderdatensatzes der Person, die den Lead besitzt. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Grund | Grund für die Lead-Disqualifizierung, z. B. disqualifizieren. Datentyp: Zeichenfolge Max. Länge: 40 Zeichen |
| short_description | Kurzbeschreibung des Leads. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Similar_Lead | Details zu ähnlichen Leads. Verwenden Sie dies für eine mögliche Lead-Disqualifizierung. Datentyp: Objekt "similar_lead": { "name": "String", "sys_id": "String" } |
| similar_lead.name | Name des doppelten Leads. Datentyp: Zeichenfolge |
| Similar_Lead.sys_ID | SYS_ID des Lead-Datensatzes, der ein möglicher doppelter Lead ist. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| Phase | Phase des Leads, z. B. 100_New. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Phasenfeld der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Staat | Status, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Straße | Straße, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| sys_class_name | Vom System generierter Klassenname der Lead-Tabelle. Datentyp: Zeichenfolge |
| sys_created_by | Anwendername der Person, die den Lead erstellt hat. Datentyp: Zeichenfolge |
| sys_created_on | Vom System generiertes Datum und Uhrzeit der Erstellung des Leads. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| sys_created_on. ​Display_value | Datum und Uhrzeit der Erstellung des Leads. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| sys_created_on. ​Wert | Datum und Uhrzeit der Erstellung des Leads. Datentyp: Zeichenfolge Format: UTC |
| sys_Domain | SYS_ID des Domänendatensatzes, zu dem der Lead gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| sys_Domain_path | Pfad der Domäne, zu der der Lead gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des Lead-Datensatzes. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| sys_mod_count | Gibt an, wie oft der zugeordnete Lead-Datensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| sys_Tags | Liste der System-Tags, die dem Lead zugeordnet sind. Sie können diese Tags verwenden, um Leads zu kategorisieren. Datentyp: Array |
| sys_updated_by | Anwendername der Person, die den Lead-Datensatz zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| sys_updated_on | Vom System generiertes Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| sys_updated_on. ​Display_value | Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Zeichenfolge Format: Standardformat und Zeitzone der Instanz |
| sys_updated_on. ​Wert | Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Zeichenfolge Format: UTC |
| Titel | Titel des Leads. Datentyp: Zeichenfolge |
| Website | Website-URL des Lead. Datentyp: Zeichenfolge |
| Work_Notes | Liste der für den Lead erstellten Arbeitsnotizen. Datentyp: Array von Objekten "work_notes": [ { "author": "String", "date": "String", "text": "String" } ] |
| Work_Notes. ​Autor | Anwendername der Person, die die zugehörige Arbeitsnotiz erstellt hat. Datentyp: Zeichenfolge |
| Work_Notes. ​Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Postleitzahl | Postleitzahl des zugeordneten Leads. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie Abfrageparameter übergeben werden, um die zurückzugebenden Leads anzugeben.

    curl "https://instance.service-now.com/api/sn_lead_mgmt_core/lead?sysparm_query=stage%3D400_closed_won&sysparm_fields=sys_id%2Cfirst_name%2Clast_name%2Cshort_description%2Cstage%2Clead_line_items&sysparm_offset=2" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username":"password"

Leads werden in einem Array von Objekten zurückgegeben:

    [
      {
        "short_description": "Looking for a quote on preventative maintenance plans for their corporate office building elevators.",
        "reason": null,
        "country": "USA",
        "closed_date": null,
        "city": "San Francisco",
        "lead_source": "inbound_phone",
        "external_id": null,
        "industry": "manufacturing",
        "sys_updated_on": {
          "value": "2024-05-31 11:01:55",
          "display_value": "2024-05-31 04:01:55"
        },
        "title": "Director of Building operations",
        "sys_class_name": "Lead",
        "number": "LEAD0000001",
        "sys_id": "856b6a95ffde8210b85dffffffffffd7",
        "business_phone": "+1 (555) 123-4567",
        "similar_lead": null,
        "sys_updated_by": "admin",
        "mobile_phone": null,
        "street": "789, Industrial drive",
        "sys_created_on": {
          "value": "2024-05-20 10:32:41",
          "display_value": "2024-05-20 03:32:41"
        },
        "contact": null,
        "company": "Lee Manufacturing Inc",
        "state": "CA",
        "first_name": "James",
        "email": "james.wilson@email.com",
        "consumer": null,
        "sys_created_by": "admin",
        "zip": "94016",
        "owner": {
          "sys_id": "60058fe943fe3110d6c6cd60afb8f203",
          "name": "Max Blaze"
        },
        "website": null,
        "lead_group": null,
        "sys_mod_count": 1,
        "last_name": "Wilson",
        "other_reason": null,
        "middle_name": null,
        "sys_tags": null,
        "do_not_share": false,
        "lead_score": 92,
        "stage": "300_nurturing",
        "do_not_email": false,
        "lead_type": null,
        "work_notes": [
          {
            "author": "Abel Tuter",
            "date": "2024-12-04 06:52:07",
            "text": "Work notes for lead"
          }
        ],
        "do_not_call": false,
        "lead_rating": "400_super_hot",
        "account": null,
        "external_system": null,
        "lead_line_items": [
          {
            "quantity": 6,
            "product_offering": {
              "sys_id": "32619d9fd0a63110f8770dbf976be1f9",
              "name": "Safety Test Coverage",
              "code": "SAFETSTCVG1"
            },
            "sys_mod_count": 0,
            "external_id": null,
            "sys_updated_on": {
              "value": "2024-05-20 10:38:41",
              "display_value": "2024-05-20 03:38:41"
            },
            "sys_tags": null,
            "lead": {
              "sys_id": "856b6a95ffde8210b85dffffffffffd7",
              "name": "LEAD0000001"
            },
            "number": "LEADL0000003",
            "sys_id": "013daa19ffde8210b85dffffffffff82",
            "unit_of_measurement": {
              "sys_id": "cb2795d553020110286eddeeff7b12ff",
              "name": "Each"
            },
            "sys_updated_by": "admin",
            "sys_created_on": {
              "value": "2024-05-20 10:38:41",
              "display_value": "2024-05-20 03:38:41"
            },
            "work_notes": null,
            "sys_created_by": "admin",
            "external_system": null
          }
        ]
      },
      {
        "short_description": "Partner referral for a company interested in a reliable internet bundle with strong security features for their office.",
        "reason": null,
        "country": "USA",
        "closed_date": null,
        "city": "San Francisco",
        "lead_source": "partner_referral",
        "external_id": null,
        "industry": "technology_services",
        "sys_updated_on": {
          "value": "2024-05-20 10:53:59",
          "display_value": "2024-05-20 03:53:59"
        },
        "title": "IT Director",
        "sys_class_name": "Lead",
        "number": "LEAD0000002",
        "sys_id": "e71fa6d9ffde8210b85dffffffffff51",
        "business_phone": "(626) 722-6969",
        "similar_lead": null,
        "sys_updated_by": "admin",
        "mobile_phone": null,
        "street": "747 Howard St",
        "sys_created_on": {
          "value": "2024-05-20 10:49:12",
          "display_value": "2024-05-20 03:49:12"
        },
        "contact": {
          "sys_id": "4d147a386f0331003b3c498f5d3ee437",
          "name": ""
        },
        "company": "Boxeo",
        "state": "CA",
        "first_name": "Julie",
        "email": "julie.lewis@example.com",
        "consumer": null,
        "sys_created_by": "admin",
        "zip": "94013",
        "owner": {
          "sys_id": "60058fe943fe3110d6c6cd60afb8f203",
          "name": "Max Blaze"
        },
        "website": null,
        "lead_group": null,
        "sys_mod_count": 0,
        "last_name": "Lewis",
        "other_reason": null,
        "middle_name": null,
        "sys_tags": null,
        "do_not_share": false,
        "lead_score": 78,
        "stage": "400_closed_won",
        "do_not_email": false,
        "lead_type": null,
        "work_notes": [
          {
            "author": "Abel Tuter",
            "date": "2024-12-03 03:52:51",
            "text": "Work noted for LEAD0000002"
          }
        ],
        "do_not_call": false,
        "lead_rating": "200_warm",
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "name": ""
        },
        "external_system": null,
        "lead_line_items": [
          {
            "quantity": 50,
            "product_offering": {
              "sys_id": "0b61dd9fd0a63110f8770dbf976be171",
              "name": "Solana Modem M Series",
              "code": "SOLANAMODE2"
            },
            "sys_mod_count": 0,
            "external_id": null,
            "sys_updated_on": { 
              "value": "2024-05-20 10:51:57",
              "display_value": "2024-05-20 03:51:57"
            },
            "sys_tags": null,
            "lead": {
              "sys_id": "e71fa6d9ffde8210b85dffffffffff51",
              "name": "LEAD0000002"
            },
            "number": "LEADL0000009",
            "sys_id": "2130fa1dffde8210b85dffffffffffff",
            "unit_of_measurement": {
              "sys_id": "cb2795d553020110286eddeeff7b12ff",
              "name": "Each"
            },
            "sys_updated_by": "admin",
            "sys_created_on": { 
              "value": "2024-05-20 10:51:25", 
              "display_value": "2024-05-20 03:51:25"
            },
            "work_notes": null,
            "sys_created_by": "admin",
            "external_system": null
          } 
        ]
      }
    ] 

## Lead -- RUFT /sn_lead_mgmt_core/Lead/{sys_ID} AB {#ariaid-title3}

Gibt den Lead-Datensatz und alle zugehörigen Lead-Positionselemente für die angegebene sys_ID zurück
Dieser Endpunkt ruft Informationen aus den folgenden Tabellen ab:

* Lead \[sn_lead_mgmt_core_lead\]
* Lead-Positionselement \[sn_lead_mgmt_core_lead_line_item\]
{#lead-GET-lead-sys_id__ul_w1b_f1m_rdc}

### URL-Format

Versionierte URL: /api/sn_lead_mgmt_core/{api_Version}/Lead/{sys_ID}

Standard-URL: /api/sn_lead_mgmt_core/{api_Version}/Lead/{sys_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

{#lead-GET-lead-sys_id__entry__2}{#lead-GET-lead-sys_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 |
| sys_id | SYS_ID des abzurufenden Leads. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
[Tabelle : 7. Pfad-Parameter]

{#lead-GET-lead-sys_id__entry__8}

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

{#lead-GET-lead-sys_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.").
{#lead-GET-lead-sys_id__entry__16}{#lead-GET-lead-sys_id__accept-JSON-only-entry-RESTAPI}

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

{#lead-GET-lead-sys_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.").
{#lead-GET-lead-sys_id__entry__24}{#lead-GET-lead-sys_id__entry-200-status-code}{#lead-GET-lead-sys_id__entry-403-status-code}{#lead-GET-lead-sys_id__entry-404-status-code}{#lead-GET-lead-sys_id__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 403 | Unzulässig. Der Anwender hat keine Zugriffsrechte für den angegebenen Datensatz. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 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

{#lead-GET-lead-sys_id__table_h4v_1hp_sdc__entry__2}{#lead-GET-lead-sys_id__lead-account-entry}{#lead-GET-lead-sys_id__lead-account.name-entry}{#lead-GET-lead-sys_id__lead-account.sys_id-entry}{#lead-GET-lead-sys_id__lead-business_phone-entry}{#lead-GET-lead-sys_id__lead-city-entry}{#lead-GET-lead-sys_id__lead-closed_date-ph}{#lead-GET-lead-sys_id__lead-closed_date.display_value-entry}{#lead-GET-lead-sys_id__lead-closed_date.value-entry}{#lead-GET-lead-sys_id__lead-company-entry}{#lead-GET-lead-sys_id__lead-consumer-ph}{#lead-GET-lead-sys_id__lead-consumer.name-entry}{#lead-GET-lead-sys_id__lead-consumer.sys_id-entry}{#lead-GET-lead-sys_id__lead-contact-ph}{#lead-GET-lead-sys_id__lead-contact.name-entry}{#lead-GET-lead-sys_id__lead-contact.sys_id-entry}{#lead-GET-lead-sys_id__lead-country-entry}{#lead-GET-lead-sys_id__lead-do_not_call-entry}{#lead-GET-lead-sys_id__lead-do_not_email-entry}{#lead-GET-lead-sys_id__lead-do_not_share-entry}{#lead-GET-lead-sys_id__lead-email-entry}{#lead-GET-lead-sys_id__lead-external_id-entry}{#lead-GET-lead-sys_id__lead-external_system-entry}{#lead-GET-lead-sys_id__lead-first_name-entry}{#lead-GET-lead-sys_id__lead-industry-entry}{#lead-GET-lead-sys_id__lead-last_name-entry}{#lead-GET-lead-sys_id__lead-lead_group-entry}{#lead-GET-lead-sys_id__lead-lead_group.name-entry}{#lead-GET-lead-sys_id__lead-lead_group.sys_id-entry}{#lead-GET-lead-sys_id__lead-lead_line_items-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.external_id-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.external_system-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.lead-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.lead.name-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.lead.sys_id-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.number-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.product_offering-ph}{#lead-GET-lead-sys_id__lead-lead_line_items.product_offering.code-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.product_offering.name-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.product_offering.sys_id-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.quantity-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_created_by-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_created_on-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_created_on.display_value-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_created_on.value-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_domain-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_domain_path-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_id-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_mod_count-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_tags-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_updated_by-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_updated_on-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_updated_on.display_value-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.sys_updated_on.value-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.unit_of_measurement-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.unit_of_measurement.name-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.unit_of_measurement.sys_id-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.work_notes-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.work_notes.author-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.work_notes.date-entry}{#lead-GET-lead-sys_id__lead-lead_line_items.work_notes.text-entry}{#lead-GET-lead-sys_id__lead-lead_rating-entry}{#lead-GET-lead-sys_id__lead-lead_score-entry}{#lead-GET-lead-sys_id__lead-lead_source-entry}{#lead-GET-lead-sys_id__lead-lead_type-entry}{#lead-GET-lead-sys_id__lead-middle_name-entry}{#lead-GET-lead-sys_id__lead-mobile_phone-entry}{#lead-GET-lead-sys_id__lead-number-entry}{#lead-GET-lead-sys_id__lead-other_reason-entry}{#lead-GET-lead-sys_id__lead-owner-entry}{#lead-GET-lead-sys_id__lead-owner.name-entry}{#lead-GET-lead-sys_id__lead-owner.sys_id-entry}{#lead-GET-lead-sys_id__lead-reason-entry}{#lead-GET-lead-sys_id__lead-short_description-entry}{#lead-GET-lead-sys_id__lead-similar_lead-entry}{#lead-GET-lead-sys_id__lead-similar_lead.name-entry}{#lead-GET-lead-sys_id__lead-similar_lead.sys_id-entry}{#lead-GET-lead-sys_id__lead-stage-entry}{#lead-GET-lead-sys_id__lead-state-entry}{#lead-GET-lead-sys_id__lead-street-entry}{#lead-GET-lead-sys_id__lead-sys_class_name-entry}{#lead-GET-lead-sys_id__lead-sys_created_by-entry}{#lead-GET-lead-sys_id__lead-sys_created_on-entry}{#lead-GET-lead-sys_id__lead-sys_created_on.display_value-entry}{#lead-GET-lead-sys_id__lead-sys_created_on.value-entry}{#lead-GET-lead-sys_id__lead-sys_domain-entry}{#lead-GET-lead-sys_id__lead-sys_domain_path-entry}{#lead-GET-lead-sys_id__lead-sys_id-entry}{#lead-GET-lead-sys_id__lead-sys_mod_count-entry}{#lead-GET-lead-sys_id__lead-sys_tags-entry}{#lead-GET-lead-sys_id__lead-sys_updated_by-entry}{#lead-GET-lead-sys_id__lead-sys_updated_on-entry}{#lead-GET-lead-sys_id__lead-sys_updated_on.display_value-entry}{#lead-GET-lead-sys_id__lead-sys_updated_on.value-entry}{#lead-GET-lead-sys_id__lead-title-entry}{#lead-GET-lead-sys_id__lead-website-entry}{#lead-GET-lead-sys_id__lead-work_notes-entry}{#lead-GET-lead-sys_id__lead-work_notes.author-entry}{#lead-GET-lead-sys_id__lead-work_notes.date-entry}{#lead-GET-lead-sys_id__lead-work_notes.text-entry}{#lead-GET-lead-sys_id__lead-zip-entry}

| Name | Beschreibung |
|-|-|
| Account | Account, der mit dem Lead verknüpft ist. Datentyp: Objekt "account": { "name": "String", "sys_id": "String" } |
| account.name | Name des Accounts. Datentyp: Zeichenfolge |
| Account.sys_ID | SYS_ID des zugeordneten Account-Datensatzes. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\] |
| business_phone | Geschäftliche Telefonnummer des Leads. Datentyp: Zeichenfolge |
| city | Stadt, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| Closed_date | Datum und Uhrzeit der Schließung des Leads. Datentyp: Objekt "closed_date": { "display_value": "String", "value": "String" } |
| Closed_date. ​Display_value | Datum und Uhrzeit wie in der Anwenderoberfläche angezeigt. Datentyp: Zeichenfolge Format: Format und Zeitzone des Anwenders. |
| Closed_date.value | Datum und Uhrzeit, zu der der Lead geschlossen wurde, wie im zugehörigen Datensatz definiert. Datentyp: Zeichenfolge Format: UTC |
| Unternehmen | Unternehmensname des Leads. Datentyp: Zeichenfolge |
| consumer | Verbraucher, der dem Lead zugeordnet ist. Datentyp: Objekt "consumer": { "name": "String", "sys_id": "String" } |
| consumer.name | Name des zugeordneten Verbrauchers. Datentyp: Zeichenfolge |
| Consumer.sys_ID | SYS_ID des zugeordneten Verbraucherdatensatzes. Datentyp: Zeichenfolge Tabelle: Verbraucher \[csm_Consumer\] |
| Kontakt | Kontakt, der dem Lead-Account zugeordnet ist. Datentyp: Objekt "contact": { "name": "String", "sys_id": "String" } |
| contact.name | Name des Kontakts. Datentyp: Zeichenfolge |
| Contact.sys_ID | SYS_ID des zugeordneten Kontaktdatensatzes. Datentyp: Zeichenfolge Tabelle: Kontakt \[Customer_contact\] |
| country | Land, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Do_Not_Call | Kennzeichnung, die angibt, ob der Kommunikationsmodus per Telefon erfolgt. Gültige Werte: * Wahr: Kann Kontakt anrufen. * Falsch: Kontakt nicht anrufen. Datentyp: Boolescher Wert |
| Do_Not_email | Kennzeichnung, die angibt, ob der Kommunikationsmodus per E-Mail erfolgt. Gültige Werte: * Wahr: Kann Kontakt per E-Mail senden. * Falsch: Senden Sie keine E-Mail an den Kontakt. Datentyp: Boolescher Wert |
| Nicht_freigeben | Kennzeichnung, die angibt, ob die Lead-Details freigegeben werden können. Gültige Werte: * Wahr: Lead-Details können freigegeben werden. * Falsch: Lead-Details können nicht geteilt werden. Datentyp: Boolescher Wert |
| E-Mail | E-Mail-Adresse des Leads. Datentyp: Zeichenfolge |
| external_id | ID, die vom System verwendet wird, das den Lead generiert hat, um den Lead im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| External_System | Name des externen Systems, das dem Lead zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| first_name | Vorname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Branche | Branche, zu der der Lead gehört. Datentyp: Zeichenfolge Tabelle: Befindet sich in industryFeld der Account-Tabelle \[Customer_Account\]. |
| last_name | Nachname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Lead_Group | Gruppe, zu der der Lead gehört. Datentyp: Objekt "lead_group": { "name: "String", "sys_id": "String" } |
| lead_group.name | Name der Lead-Gruppe. Datentyp: Zeichenfolge |
| Lead_Group.sys_ID | SYS_ID des Lead-Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| Lead_line_items | Details der Lead-Positionselemente, die dem Lead zugeordnet sind. Datentyp: Array von Objekten "lead_line_items": [ { "external_id": "String", "external_system": "String", "lead": {Object}, "number": "String", "product_offering": {Object}, "quantity": Number, "sys_created_by": "String", "sys_created_on {Object}, "sys_domain": "String", "sys_domain_path": "String", "sys_id": "String", "sys_mod_count": Number, "sys_tags": [Array], "sys_updated_by: "String", "sys_updated_on: {Object}, "unit_of_measurement": {Object}, "work_notes": [Array] } ] |
| Lead_line_items. ​External_ID | ID, die vom System verwendet wird, das die Lead-Position generiert hat, um die Position im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| Lead_line_items. ​External_System | Name des externen Systems, das dem Lead-Positionselement zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| Lead_line_items. ​Lead | Details zum Lead, der der Position zugeordnet ist. Datentyp: Objekt "lead: { "name": "String", "sys_id": "String" } |
| Lead_line_items. ​lead.name | Name des zugeordneten Leads. Datentyp: Zeichenfolge |
| Lead_line_items. ​Lead.sys_ID | SYS_ID des zugeordneten Lead-Datensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​Nummer | Eindeutige vom System generierte Nummer des Lead-Positionselementdatensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​Product_Offering | Informationen zum Produktangebot, das der Lead-Position zugeordnet ist. Datentyp: Objekt "product_offering": { "code": " String", "name": "String", "sys_id": "String" } |
| Lead_line_items. ​Product_offering.Code | Code, der mit dem Produktangebot verknüpft ist. Hinweis: Dies ist eine vom System generierte alphanumerische Nummer basierend auf dem Produktnamen. Obwohl vom System generiert, können Sie den Code bearbeiten, um eine SKU oder andere branchenspezifische Produktcodes darzustellen. Datentyp: Zeichenfolge |
| Lead_line_items. ​product_offering.name | Name des Produktangebots. Datentyp: Zeichenfolge |
| Lead_line_items. ​Product_Offering.sys_ID | SYS_ID des Produktangebotsdatensatzes, der der Lead-Position zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| Lead_line_items. ​Menge | Menge der Artikel, die der Lead des zugehörigen Produktangebots kaufen möchte. Datentyp: Zahl (Ganzzahl) |
| Lead_line_items. ​sys_created_by | Anwendername der Person, die die Lead-Position erstellt hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_created_on | Vom System generiertes Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| Lead_line_items. ​sys_created_on.display_value | Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| Lead_line_items. ​sys_created_on.value | Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Zeichenfolge Format: UTC |
| Lead_line_items. ​sys_Domain | SYS_ID des Domänendatensatzes, zu dem das Lead-Positionselement gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| lead_line_items.sys_domain_path | Pfad der Domäne, zu der das Lead-Positionselement gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_ID | SYS_ID des Lead-Positionselementdatensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_mod_count | Gibt an, wie oft der zugehörige Lead-Positionselementdatensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| Lead_line_items. ​sys_Tags | Liste der System-Tags, die dem Lead-Positionselement zugeordnet sind. Datentyp: Array |
| Lead_line_items. ​sys_updated_by | Anwendername der Person, die die zugehörige Lead-Position zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_updated_on | Vom System generiertes Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| Lead_line_items. ​sys_updated_on. ​Display_value | Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| Lead_line_items. ​sys_updated_on. ​Wert | Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Zeichenfolge Format: UTC |
| Lead_line_items. ​Unit_of_Measurement | Details der Maßeinheit des Lead-Positionselements. Datentyp: Objekt "unit_of_measurement": { "name": "String", "sys_id": "String" } |
| Lead_line_items. ​Unit_of_Measurement. ​Name | Name der Maßeinheit, z. B. „einzeln" oder „Kubikfuß". Datentyp: Zeichenfolge |
| Lead_line_items. ​Unit_of_Measurement. ​sys_ID | SYS_ID des Datensatzes, der die Maßeinheit beschreibt. Datentyp: Zeichenfolge Tabelle: Maßeinheit \[sn_prd_pm_uom\] |
| Lead_line_items. ​Work_Notes | Liste, die die für die Lead-Position erstellten Arbeitsnotizen beschreibt. Datentyp: Array von Objekten "work_notes": [ { "author": "String", "date": "String", "text": "String" } ] |
| Lead_line_items. ​Work_Notes. ​Autor | Anwendername der Person, die die zugehörige Arbeitsnotiz erstellt hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​Work_Notes. ​Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Lead_line_items. ​Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Lead_Rating | Bewertung für den Lead, z. B. 100_kalt, 200_warm, 300_hot oder 400_super_hot. Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_Rating" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_Score | Punktzahl für den Lead. Datentyp: Decimal Bereich: 1 bis 100 |
| Lead_Source | Urheber des Leads. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Feld „Lead_Source" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_type | Typ des Leads, z. B. „Neues Geschäft" oder „vorhandenes Geschäft". Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_type" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Middle_Name | Zweiter Vorname des Kontakts für den Lead. Datentyp: Zeichenfolge |
| mobile_phone | Telefonnummer des Kontakts für den Lead. Datentyp: Zeichenfolge |
| Nummer | Eindeutige vom System generierte Nummer des Lead-Datensatzes. Datentyp: Zeichenfolge |
| Other_reason | Zusätzlicher Grund für die Lead-Disqualifizierung. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Eigentümer | Details der Person, die dem Lead zugeordnet ist. Datentyp: Objekt "owner": { "name": "String", "sys_id": "String" } |
| owner.name | Name der Person, die den Lead besitzt. Datentyp: Zeichenfolge |
| Besitzer.sys_ID | SYS_ID des Anwenderdatensatzes der Person, die den Lead besitzt. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Grund | Grund für die Lead-Disqualifizierung, z. B. disqualifizieren. Datentyp: Zeichenfolge Max. Länge: 40 Zeichen |
| short_description | Kurzbeschreibung des Leads. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Similar_Lead | Details zu ähnlichen Leads. Verwenden Sie dies für eine mögliche Lead-Disqualifizierung. Datentyp: Objekt "similar_lead": { "name": "String", "sys_id": "String" } |
| similar_lead.name | Name des doppelten Leads. Datentyp: Zeichenfolge |
| Similar_Lead.sys_ID | SYS_ID des Lead-Datensatzes, der ein möglicher doppelter Lead ist. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| Phase | Phase des Leads, z. B. 100_New. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Phasenfeld der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Staat | Status, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Straße | Straße, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| sys_class_name | Vom System generierter Klassenname der Lead-Tabelle. Datentyp: Zeichenfolge |
| sys_created_by | Anwendername der Person, die den Lead erstellt hat. Datentyp: Zeichenfolge |
| sys_created_on | Vom System generiertes Datum und Uhrzeit der Erstellung des Leads. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| sys_created_on. ​Display_value | Datum und Uhrzeit der Erstellung des Leads. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| sys_created_on. ​Wert | Datum und Uhrzeit der Erstellung des Leads. Datentyp: Zeichenfolge Format: UTC |
| sys_Domain | SYS_ID des Domänendatensatzes, zu dem der Lead gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| sys_Domain_path | Pfad der Domäne, zu der der Lead gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des Lead-Datensatzes. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| sys_mod_count | Gibt an, wie oft der zugeordnete Lead-Datensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| sys_Tags | Liste der System-Tags, die dem Lead zugeordnet sind. Sie können diese Tags verwenden, um Leads zu kategorisieren. Datentyp: Array |
| sys_updated_by | Anwendername der Person, die den Lead-Datensatz zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| sys_updated_on | Vom System generiertes Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| sys_updated_on. ​Display_value | Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Zeichenfolge Format: Standardformat und Zeitzone der Instanz |
| sys_updated_on. ​Wert | Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Zeichenfolge Format: UTC |
| Titel | Titel des Leads. Datentyp: Zeichenfolge |
| Website | Website-URL des Lead. Datentyp: Zeichenfolge |
| Work_Notes | Liste der für den Lead erstellten Arbeitsnotizen. Datentyp: Array von Objekten "work_notes": [ { "author": "String", "date": "String", "text": "String" } ] |
| Work_Notes. ​Autor | Anwendername der Person, die die zugehörige Arbeitsnotiz erstellt hat. Datentyp: Zeichenfolge |
| Work_Notes. ​Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Postleitzahl | Postleitzahl des zugeordneten Leads. Datentyp: Zeichenfolge |
[ ]

{#lead-GET-lead-sys_id__table_h4v_1hp_sdc}  

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie der Lead-Datensatz mit der sys_ID 856b6a95ffde8210b85dffffffffd7 abgerufen wird.

    curl "https://instance.service-now.com /api/sn_lead_mgmt_core/lead/856b6a95ffde8210b85dffffffffffd7" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username":"password" 

Im Folgenden werden die Rückgabeergebnisse aufgeführt:

    { 
      "short_description": "Looking for a quote on preventative maintenance plans for their corporate office building elevators.",
      "reason": null,
      "country": "USA",
      "closed_date": null,
      "city": "San Francisco",
      "lead_source": "inbound_phone",
      "external_id": null,
      "industry": "manufacturing",
      "sys_updated_on": {
        "value": "2024-05-31 11:01:55",
        "display_value": "2024-05-31 04:01:55"
      },
      "title": "Director of Building operations",
      "sys_class_name": "Lead",
      "number": "LEAD0000001",
      "sys_id": "856b6a95ffde8210b85dffffffffffd7",
      "business_phone": "+1 (555) 123-4567",
      "similar_lead": null,
      "sys_updated_by": "abel.tuter",
      "mobile_phone": null,
      "street": "789, Industrial drive",
      "sys_created_on": {
        "value": "2024-05-20 10:32:41",
        "display_value": "2024-05-20 03:32:41"
      },
      "contact": null,
      "company": "Lee Manufacturing Inc",
      "state": "CA",
      "first_name": "James",
      "email": "james.wilson@email.com",
      "consumer": null,
      "sys_created_by": "abel.tuter",
      "zip": "94016",
      "owner": {
        "sys_id": "60058fe943fe3110d6c6cd60afb8f203",
        "name": "Max Blaze"
      },
      "website": null,
      "lead_group": null,
      "sys_mod_count": 1,
      "last_name": "Wilson",
      "other_reason": null,
      "middle_name": null,
      "sys_tags": null,
      "do_not_share": false,
      "lead_score": 92,
      "stage": "300_nurturing",
      "do_not_email": false,
      "lead_type": null,
      "work_notes": [
        {
          "author": "Abel Tuter",
          "date": "2024-12-04 06:52:07",
          "text": "Work notes for lead" 
        }
      ],
      "do_not_call": false,
      "lead_rating": "400_super_hot",
      "account": null,
      "external_system": null, 
      "lead_line_items": [
        {
          "quantity": 6,
          "product_offering": {
            "sys_id": "32619d9fd0a63110f8770dbf976be1f9",
            "name": "Safety Test Coverage",
            "code": "SAFETSTCVG1"
          },
          "sys_mod_count": 0,
          "external_id": null,
          "sys_updated_on": {
            "value": "2024-05-20 10:38:41",
            "display_value": "2024-05-20 03:38:41" 
          },
          "sys_tags": null,
          "lead": {
            "sys_id": "856b6a95ffde8210b85dffffffffffd7",
            "name": "LEAD0000001"
          },
          "number": "LEADL0000003", 
          "sys_id": "013daa19ffde8210b85dffffffffff82",
          "unit_of_measurement": { 
            "sys_id": "cb2795d553020110286eddeeff7b12ff",
            "name": "Each"
          },
          "sys_updated_by": "abel.tuter",
          "sys_created_on": {
            "value": "2024-05-20 10:38:41",
            "display_value": "2024-05-20 03:38:41"
          },
          "work_notes": null,
          "sys_created_by": "abel.tuter",
          "external_system": null
        }
      ]
    } 

## Lead -- PATCH /sn_lead_mgmt_core/Lead/{sys_ID} {#ariaid-title4}

Aktualisiert den angegebenen Lead-Datensatz und die zugehörigen Lead-Positionselemente. Sie können diesen Endpunkt auch verwenden, um dem angegebenen Lead neue Lead-Positionselemente zuzuordnen.
Dieser Endpunkt aktualisiert Informationen in den folgenden Tabellen:

* Lead \[sn_lead_mgmt_core_lead\]
* Lead-Positionselement \[sn_lead_mgmt_core_lead_line_item\]
{#lead-PATCH-lead__ul_ebj_kg4_sdc}  
Regeln für übergebene Parameter:

* Ungültige Parameternamen werden ignoriert.
* Ungültige Werte für nicht obligatorische Auswahlfelder und Referenzfelder werden ignoriert.
* Wenn der FELDSCHREIBZUGRIFF für ein oder mehrere Felder verweigert wird, werden die eingeschränkten Felder ignoriert.
* Sie können mit dieser API keine Systemfeldwerte einfügen. Alle angegebenen Werte werden ignoriert. Systemfelder sind Teil der Liste „ignorierte Felder", die konfigurierbar ist.
* Die Werte der Parameter account, contact, Und consumerWerden ignoriert, wenn beide verwendet werden accountUnd consumerParameter sind nicht leer.
* Sofern nicht anders angegeben, ist der Standardwert für alle nicht übergebenen Parameter „null".  
Hinweis:  
Dieser Endpunkt ändert nur die angegebenen Parameter. Wenn ein Parameter, der im aktuellen Lead- oder Lead-Positionselement-Datensatz vorhanden ist, im Aufruf nicht angegeben ist, bleibt sein Inhalt unverändert.

### URL-Format

Versionierte URL: /api/sn_lead_mgmt_core/{api_Version}/Lead/{sys_ID}

Standard-URL: /api/sn_lead_mgmt_core/{api_Version}/Lead/{sys_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

{#lead-PATCH-lead__entry__2}{#lead-PATCH-lead__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 |
| sys_id | SYS_ID des zu aktualisierenden Lead-Datensatzes. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
[Tabelle : 13. Pfad-Parameter]

{#lead-PATCH-lead__entry__8}

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

{#lead-PATCH-lead__entry__12}{#lead-PATCH-lead__lead-account-entry}{#lead-PATCH-lead__lead-account.sys_id-entry}{#lead-PATCH-lead__lead-business_phone-entry}{#lead-PATCH-lead__lead-city-entry}{#lead-PATCH-lead__lead-company-entry}{#lead-PATCH-lead__lead-consumer.sys_id-entry}{#lead-PATCH-lead__lead-contact.sys_id-entry}{#lead-PATCH-lead__lead-country-entry}{#lead-PATCH-lead__lead-do_not_call-entry}{#lead-PATCH-lead__lead-do_not_email-entry}{#lead-PATCH-lead__lead-do_not_share-entry}{#lead-PATCH-lead__lead-email-entry}{#lead-PATCH-lead__lead-external_id-entry}{#lead-PATCH-lead__lead-external_system-entry}{#lead-PATCH-lead__lead-first_name-entry}{#lead-PATCH-lead__lead-industry-entry}{#lead-PATCH-lead__lead-lead_group.sys_id-entry}{#lead-PATCH-lead__lead-lead_line_items.external_id-entry}{#lead-PATCH-lead__lead-lead_line_items.external_system-entry}{#lead-PATCH-lead__lead-lead_line_items.work_notes.text-entry}{#lead-PATCH-lead__lead-lead_rating-entry}{#lead-PATCH-lead__lead-lead_score-entry}{#lead-PATCH-lead__lead-lead_source-entry}{#lead-PATCH-lead__lead-lead_type-entry}{#lead-PATCH-lead__lead-middle_name-entry}{#lead-PATCH-lead__lead-mobile_phone-entry}{#lead-PATCH-lead__lead-other_reason-entry}{#lead-PATCH-lead__lead-owner.sys_id-entry}{#lead-PATCH-lead__lead-reason-entry}{#lead-PATCH-lead__lead-short_description-entry}{#lead-PATCH-lead__lead-similar_lead.sys_id-entry}{#lead-PATCH-lead__lead-stage-entry}{#lead-PATCH-lead__lead-state-entry}{#lead-PATCH-lead__lead-street-entry}{#lead-PATCH-lead__lead-title-entry}{#lead-PATCH-lead__lead-website-entry}{#lead-PATCH-lead__lead-work_notes.text-entry}{#lead-PATCH-lead__lead-zip-entry}

| Name | Beschreibung |
|-|-|
| Account | Details des Accounts, der dem Lead zugeordnet ist. Datentyp: Objekt "account": { "sys_id": "String" } |
| Account.sys_ID | SYS_ID des zugeordneten Account-Datensatzes. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\] |
| business_phone | Geschäftliche Telefonnummer des Leads. Datentyp: Zeichenfolge |
| city | Stadt, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| Unternehmen | Unternehmensname des Leads. Datentyp: Zeichenfolge |
| consumer | Verbraucher, der dem Lead zugeordnet ist. Datentyp: Objekt "consumer": { "sys_id": "String" } |
| Consumer.sys_ID | SYS_ID des zugeordneten Verbraucherdatensatzes. Datentyp: Zeichenfolge Tabelle: Verbraucher \[csm_Consumer\] |
| Kontakt | Kontakt, der dem Lead-Account zugeordnet ist. Datentyp: Objekt "contact": { "sys_id": "String" } |
| Contact.sys_ID | SYS_ID des zugeordneten Kontaktdatensatzes. Datentyp: Zeichenfolge Tabelle: Kontakt \[Customer_contact\] |
| country | Land, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Do_Not_Call | Kennzeichnung, die angibt, ob der Kommunikationsmodus per Telefon erfolgt. Gültige Werte: * Wahr: Kann Kontakt anrufen. * Falsch: Kontakt nicht anrufen. Datentyp: Boolescher Wert |
| Do_Not_email | Kennzeichnung, die angibt, ob der Kommunikationsmodus per E-Mail erfolgt. Gültige Werte: * Wahr: Kann Kontakt per E-Mail senden. * Falsch: Senden Sie keine E-Mail an den Kontakt. Datentyp: Boolescher Wert |
| Nicht_freigeben | Kennzeichnung, die angibt, ob die Lead-Details freigegeben werden können. Gültige Werte: * Wahr: Lead-Details können freigegeben werden. * Falsch: Lead-Details können nicht geteilt werden. Datentyp: Boolescher Wert |
| E-Mail | E-Mail-Adresse des Leads. Datentyp: Zeichenfolge |
| external_id | ID, die vom System verwendet wird, das den Lead generiert hat, um den Lead im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| External_System | Name des externen Systems, das dem Lead zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| first_name | Vorname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Branche | Branche, zu der der Lead gehört. Datentyp: Zeichenfolge Tabelle: Befindet sich in industryFeld der Account-Tabelle \[Customer_Account\]. |
| last_name | Erforderlich. Nachname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Lead_Group | Gruppe, zu der der Lead gehört. Datentyp: Objekt "lead_group": { "sys_id": "String" } |
| Lead_Group.sys_ID | SYS_ID des Lead-Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| Lead_line_items | Liste der Lead-Positionselemente, die dem Lead zugeordnet werden sollen. Gruppe, zu der der Lead gehört. Datentyp: Objekt "lead_line_items": [ { "external_id": "String", "external_system": "String", "product_offering": {Object}, "quantity": Number, "work_notes": [Array], "unit_of_measurement": {Object} } ] Maximale Anzahl von Einzelposten: 100 -- alle über, die ignoriert werden |
| Lead_line_items. ​External_ID | ID, die vom System verwendet wird, das die Lead-Position generiert hat, um die Position im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| Lead_line_items. ​External_System | Name des externen Systems, das dem Lead-Positionselement zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| lead_line_items.product_offering | Erforderlich. Informationen zum Produktangebot, das der Lead-Position zugeordnet ist. Datentyp: Objekt "product_offering": { "sys_id": "String" } |
| lead_line_items.product_offering.sys_id | Erforderlich. SYS_ID des Produktangebotsdatensatzes, der der Lead-Position zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| Lead_line_items.quantity | Menge der Artikel, die der Lead des zugehörigen Produktangebots kaufen möchte. Datentyp: Zahl (Ganzzahl) |
| Lead_line_items. ​Unit_of_Measurement | Details der Maßeinheit des Lead-Positionselements. Datentyp: Objekt "unit_of_measurement": { "sys_id": "String" } |
| Lead_line_items. ​Unit_of_Measurement​.sys_ID | SYS_ID des Datensatzes, der die Maßeinheit beschreibt. Datentyp: Zeichenfolge Tabelle: Maßeinheit \[sn_prd_pm_uom\] |
| lead_line_items.work_notes | Liste, die die für die Lead-Position erstellten Arbeitsnotizen beschreibt. Datentyp: Array von Objekten "work_notes": [ "text": "String" } ] |
| Lead_line_items. ​Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Lead_Rating | Bewertung für den Lead, z. B. 100_kalt, 200_warm, 300_hot oder 400_super_hot. Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_Rating" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_Score | Punktzahl für den Lead. Datentyp: Decimal Bereich: 1 bis 100 |
| Lead_Source | Urheber des Leads. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Feld „Lead_Source" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_type | Typ des Leads, z. B. „Neues Geschäft" oder „vorhandenes Geschäft". Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_type" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Middle_Name | Zweiter Vorname des Kontakts für den Lead. Datentyp: Zeichenfolge |
| mobile_phone | Telefonnummer des Kontakts für den Lead. Datentyp: Zeichenfolge |
| Other_reason | Zusätzlicher Grund für die Lead-Disqualifizierung. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Eigentümer | Details der Person, die dem Lead zugeordnet ist. Datentyp: Objekt "owner": { "sys_id": "String" } |
| Besitzer.sys_ID | SYS_ID des Anwenderdatensatzes der Person, die den Lead besitzt. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Grund | Grund für die Lead-Disqualifizierung, z. B. disqualifizieren. Datentyp: Zeichenfolge Max. Länge: 40 Zeichen |
| short_description | Kurzbeschreibung des Leads. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Similar_Lead | Details zu ähnlichen Leads. Verwenden Sie dies für eine mögliche Lead-Disqualifizierung. Datentyp: Objekt "similar_lead": { "sys_id": "String" } |
| Similar_Lead.sys_ID | SYS_ID des Lead-Datensatzes, der ein möglicher doppelter Lead ist. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| Phase | Phase des Leads, z. B. 100_New. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Phasenfeld der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Staat | Status, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Straße | Straße, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| Titel | Titel des Leads. Datentyp: Zeichenfolge |
| Website | Website-URL des Lead. Datentyp: Zeichenfolge |
| Work_Notes | Liste der für den Lead erstellten Arbeitsnotizen. Datentyp: Array von Objekten "work_notes": [ { "text": "String" } ] Hinweis: Ein Array von Arbeitsnotizen in der Anforderung wird als einzelner Text eingefügt. Dieser Text wird generiert, indem der Inhalt aus allen Arbeitsnotizobjekten in der Anforderung kombiniert wird, wobei jeder Eintrag durch ein Komma (,) getrennt wird. |
| Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Postleitzahl | Postleitzahl des zugeordneten Leads. Datentyp: Zeichenfolge |
[Tabelle : 15. Anforderungstext-Parameter]

### 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.").
{#lead-PATCH-lead__entry__118}{#lead-PATCH-lead__accept-JSON-only-entry-RESTAPI}{#lead-PATCH-lead__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.]

{#lead-PATCH-lead__entry__124}

| 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.").
{#lead-PATCH-lead__entry__128}{#lead-PATCH-lead__lead-400-status_code-entry}{#lead-PATCH-lead__entry-403-status-code}{#lead-PATCH-lead__entry-404-status-code}{#lead-PATCH-lead__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Datensätze für Lead- und Lead-Positionselemente wurden erfolgreich aktualisiert. |
| 400 | Fehler. Mögliche Gründe: * Ungültige Nutzlast: Ungültiger/leerer Anforderungstext. * Ungültige Nutzlast: Ungültiger Feldwert für E-Mail-/Telefonnummernfelder. * Ungültige Nutzlast: Pflichtfeld fehlt, oder sein Wert ist leer. * Ungültige Nutzlast: Phase ist „400_closed_won". Qualifizierender Lead wird mit der API nicht unterstützt. * Wenn sich die Phase des zu aktualisierenden Leads bereits im Status „Geschlossen" befindet und Sie versuchen, sie zu aktualisieren. |
| 403 | Unzulässig. Der Anwender hat keine Zugriffsrechte für den angegebenen Datensatz. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter

{#lead-PATCH-lead__entry__140}{#lead-PATCH-lead__d3520e70}{#lead-PATCH-lead__lead-account.name-entry}{#lead-PATCH-lead__d3520e94}{#lead-PATCH-lead__d3520e111}{#lead-PATCH-lead__d3520e122}{#lead-PATCH-lead__lead-closed_date-ph}{#lead-PATCH-lead__lead-closed_date.display_value-entry}{#lead-PATCH-lead__lead-closed_date.value-entry}{#lead-PATCH-lead__d3520e174}{#lead-PATCH-lead__lead-consumer-ph}{#lead-PATCH-lead__lead-consumer.name-entry}{#lead-PATCH-lead__d3520e211}{#lead-PATCH-lead__lead-contact-ph}{#lead-PATCH-lead__lead-contact.name-entry}{#lead-PATCH-lead__d3520e253}{#lead-PATCH-lead__d3520e270}{#lead-PATCH-lead__d3520e281}{#lead-PATCH-lead__d3520e306}{#lead-PATCH-lead__d3520e330}{#lead-PATCH-lead__d3520e354}{#lead-PATCH-lead__d3520e365}{#lead-PATCH-lead__d3520e376}{#lead-PATCH-lead__d3520e387}{#lead-PATCH-lead__d3520e399}{#lead-PATCH-lead__lead-last_name-entry}{#lead-PATCH-lead__lead-lead_group-entry}{#lead-PATCH-lead__lead-lead_group.name-entry}{#lead-PATCH-lead__d3520e457}{#lead-PATCH-lead__lead-lead_line_items-entry}{#lead-PATCH-lead__d3520e484}{#lead-PATCH-lead__d3520e495}{#lead-PATCH-lead__lead-lead_line_items.lead-entry}{#lead-PATCH-lead__lead-lead_line_items.lead.name-entry}{#lead-PATCH-lead__lead-lead_line_items.lead.sys_id-entry}{#lead-PATCH-lead__lead-lead_line_items.number-entry}{#lead-PATCH-lead__lead-lead_line_items.product_offering-ph}{#lead-PATCH-lead__lead-lead_line_items.product_offering.code-entry}{#lead-PATCH-lead__lead-lead_line_items.product_offering.name-entry}{#lead-PATCH-lead__lead-lead_line_items.product_offering.sys_id-entry}{#lead-PATCH-lead__lead-lead_line_items.quantity-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_created_by-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_created_on-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_created_on.display_value-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_created_on.value-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_domain-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_domain_path-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_id-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_mod_count-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_tags-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_updated_by-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_updated_on-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_updated_on.display_value-entry}{#lead-PATCH-lead__lead-lead_line_items.sys_updated_on.value-entry}{#lead-PATCH-lead__lead-lead_line_items.unit_of_measurement-entry}{#lead-PATCH-lead__lead-lead_line_items.unit_of_measurement.name-entry}{#lead-PATCH-lead__lead-lead_line_items.unit_of_measurement.sys_id-entry}{#lead-PATCH-lead__lead-lead_line_items.work_notes-entry}{#lead-PATCH-lead__lead-lead_line_items.work_notes.author-entry}{#lead-PATCH-lead__lead-lead_line_items.work_notes.date-entry}{#lead-PATCH-lead__d3520e865}{#lead-PATCH-lead__d3520e876}{#lead-PATCH-lead__d3520e889}{#lead-PATCH-lead__d3520e902}{#lead-PATCH-lead__d3520e915}{#lead-PATCH-lead__d3520e933}{#lead-PATCH-lead__d3520e945}{#lead-PATCH-lead__lead-number-entry}{#lead-PATCH-lead__d3520e967}{#lead-PATCH-lead__lead-owner-entry}{#lead-PATCH-lead__lead-owner.name-entry}{#lead-PATCH-lead__d3520e1008}{#lead-PATCH-lead__d3520e1022}{#lead-PATCH-lead__d3520e1035}{#lead-PATCH-lead__lead-similar_lead-entry}{#lead-PATCH-lead__lead-similar_lead.name-entry}{#lead-PATCH-lead__d3520e1076}{#lead-PATCH-lead__d3520e1089}{#lead-PATCH-lead__d3520e1106}{#lead-PATCH-lead__d3520e1117}{#lead-PATCH-lead__lead-sys_class_name-entry}{#lead-PATCH-lead__lead-sys_created_by-entry}{#lead-PATCH-lead__lead-sys_created_on-entry}{#lead-PATCH-lead__lead-sys_created_on.display_value-entry}{#lead-PATCH-lead__lead-sys_created_on.value-entry}{#lead-PATCH-lead__lead-sys_domain-entry}{#lead-PATCH-lead__lead-sys_domain_path-entry}{#lead-PATCH-lead__lead-sys_id-entry}{#lead-PATCH-lead__lead-sys_mod_count-entry}{#lead-PATCH-lead__lead-sys_tags-entry}{#lead-PATCH-lead__lead-sys_updated_by-entry}{#lead-PATCH-lead__lead-sys_updated_on-entry}{#lead-PATCH-lead__lead-sys_updated_on.display_value-entry}{#lead-PATCH-lead__lead-sys_updated_on.value-entry}{#lead-PATCH-lead__d3520e1302}{#lead-PATCH-lead__d3520e1313}{#lead-PATCH-lead__lead-work_notes-entry}{#lead-PATCH-lead__lead-work_notes.author-entry}{#lead-PATCH-lead__lead-work_notes.date-entry}{#lead-PATCH-lead__d3520e1364}{#lead-PATCH-lead__d3520e1375}

| Name | Beschreibung |
|-|-|
| Account | Account, der mit dem Lead verknüpft ist. Datentyp: Objekt "account": { "name": "String", "sys_id": "String" } |
| account.name | Name des Accounts. Datentyp: Zeichenfolge |
| Account.sys_ID | SYS_ID des zugeordneten Account-Datensatzes. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\] |
| business_phone | Geschäftliche Telefonnummer des Leads. Datentyp: Zeichenfolge |
| city | Stadt, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| Closed_date | Datum und Uhrzeit der Schließung des Leads. Datentyp: Objekt "closed_date": { "display_value": "String", "value": "String" } |
| Closed_date. ​Display_value | Datum und Uhrzeit wie in der Anwenderoberfläche angezeigt. Datentyp: Zeichenfolge Format: Format und Zeitzone des Anwenders. |
| Closed_date.value | Datum und Uhrzeit, zu der der Lead geschlossen wurde, wie im zugehörigen Datensatz definiert. Datentyp: Zeichenfolge Format: UTC |
| Unternehmen | Unternehmensname des Leads. Datentyp: Zeichenfolge |
| consumer | Verbraucher, der dem Lead zugeordnet ist. Datentyp: Objekt "consumer": { "name": "String", "sys_id": "String" } |
| consumer.name | Name des zugeordneten Verbrauchers. Datentyp: Zeichenfolge |
| Consumer.sys_ID | SYS_ID des zugeordneten Verbraucherdatensatzes. Datentyp: Zeichenfolge Tabelle: Verbraucher \[csm_Consumer\] |
| Kontakt | Kontakt, der dem Lead-Account zugeordnet ist. Datentyp: Objekt "contact": { "name": "String", "sys_id": "String" } |
| contact.name | Name des Kontakts. Datentyp: Zeichenfolge |
| Contact.sys_ID | SYS_ID des zugeordneten Kontaktdatensatzes. Datentyp: Zeichenfolge Tabelle: Kontakt \[Customer_contact\] |
| country | Land, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Do_Not_Call | Kennzeichnung, die angibt, ob der Kommunikationsmodus per Telefon erfolgt. Gültige Werte: * Wahr: Kann Kontakt anrufen. * Falsch: Kontakt nicht anrufen. Datentyp: Boolescher Wert |
| Do_Not_email | Kennzeichnung, die angibt, ob der Kommunikationsmodus per E-Mail erfolgt. Gültige Werte: * Wahr: Kann Kontakt per E-Mail senden. * Falsch: Senden Sie keine E-Mail an den Kontakt. Datentyp: Boolescher Wert |
| Nicht_freigeben | Kennzeichnung, die angibt, ob die Lead-Details freigegeben werden können. Gültige Werte: * Wahr: Lead-Details können freigegeben werden. * Falsch: Lead-Details können nicht geteilt werden. Datentyp: Boolescher Wert |
| E-Mail | E-Mail-Adresse des Leads. Datentyp: Zeichenfolge |
| external_id | ID, die vom System verwendet wird, das den Lead generiert hat, um den Lead im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| External_System | Name des externen Systems, das dem Lead zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| first_name | Vorname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Branche | Branche, zu der der Lead gehört. Datentyp: Zeichenfolge Tabelle: Befindet sich in industryFeld der Account-Tabelle \[Customer_Account\]. |
| last_name | Nachname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Lead_Group | Gruppe, zu der der Lead gehört. Datentyp: Objekt "lead_group": { "name: "String", "sys_id": "String" } |
| lead_group.name | Name der Lead-Gruppe. Datentyp: Zeichenfolge |
| Lead_Group.sys_ID | SYS_ID des Lead-Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| Lead_line_items | Details der Lead-Positionselemente, die dem Lead zugeordnet sind. Datentyp: Array von Objekten "lead_line_items": [ { "external_id": "String", "external_system": "String", "lead": {Object}, "number": "String", "product_offering": {Object}, "quantity": Number, "sys_created_by": "String", "sys_created_on {Object}, "sys_domain": "String", "sys_domain_path": "String", "sys_id": "String", "sys_mod_count": Number, "sys_tags": [Array], "sys_updated_by: "String", "sys_updated_on: {Object}, "unit_of_measurement": {Object}, "work_notes": [Array] } ] |
| Lead_line_items. ​External_ID | ID, die vom System verwendet wird, das die Lead-Position generiert hat, um die Position im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| Lead_line_items. ​External_System | Name des externen Systems, das dem Lead-Positionselement zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| Lead_line_items. ​Lead | Details zum Lead, der der Position zugeordnet ist. Datentyp: Objekt "lead: { "name": "String", "sys_id": "String" } |
| Lead_line_items. ​lead.name | Name des zugeordneten Leads. Datentyp: Zeichenfolge |
| Lead_line_items. ​Lead.sys_ID | SYS_ID des zugeordneten Lead-Datensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​Nummer | Eindeutige vom System generierte Nummer des Lead-Positionselementdatensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​Product_Offering | Informationen zum Produktangebot, das der Lead-Position zugeordnet ist. Datentyp: Objekt "product_offering": { "code": " String", "name": "String", "sys_id": "String" } |
| Lead_line_items. ​Product_offering.Code | Code, der mit dem Produktangebot verknüpft ist. Hinweis: Dies ist eine vom System generierte alphanumerische Nummer basierend auf dem Produktnamen. Obwohl vom System generiert, können Sie den Code bearbeiten, um eine SKU oder andere branchenspezifische Produktcodes darzustellen. Datentyp: Zeichenfolge |
| Lead_line_items. ​product_offering.name | Name des Produktangebots. Datentyp: Zeichenfolge |
| Lead_line_items. ​Product_Offering.sys_ID | SYS_ID des Produktangebotsdatensatzes, der der Lead-Position zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| Lead_line_items. ​Menge | Menge der Artikel, die der Lead des zugehörigen Produktangebots kaufen möchte. Datentyp: Zahl (Ganzzahl) |
| Lead_line_items. ​sys_created_by | Anwendername der Person, die die Lead-Position erstellt hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_created_on | Vom System generiertes Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| Lead_line_items. ​sys_created_on.display_value | Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| Lead_line_items. ​sys_created_on.value | Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Zeichenfolge Format: UTC |
| Lead_line_items. ​sys_Domain | SYS_ID des Domänendatensatzes, zu dem das Lead-Positionselement gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| lead_line_items.sys_domain_path | Pfad der Domäne, zu der das Lead-Positionselement gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_ID | SYS_ID des Lead-Positionselementdatensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_mod_count | Gibt an, wie oft der zugehörige Lead-Positionselementdatensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| Lead_line_items. ​sys_Tags | Liste der System-Tags, die dem Lead-Positionselement zugeordnet sind. Datentyp: Array |
| Lead_line_items. ​sys_updated_by | Anwendername der Person, die die zugehörige Lead-Position zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_updated_on | Vom System generiertes Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| Lead_line_items. ​sys_updated_on. ​Display_value | Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| Lead_line_items. ​sys_updated_on. ​Wert | Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Zeichenfolge Format: UTC |
| Lead_line_items. ​Unit_of_Measurement | Details der Maßeinheit des Lead-Positionselements. Datentyp: Objekt "unit_of_measurement": { "name": "String", "sys_id": "String" } |
| Lead_line_items. ​Unit_of_Measurement. ​Name | Name der Maßeinheit, z. B. „einzeln" oder „Kubikfuß". Datentyp: Zeichenfolge |
| Lead_line_items. ​Unit_of_Measurement. ​sys_ID | SYS_ID des Datensatzes, der die Maßeinheit beschreibt. Datentyp: Zeichenfolge Tabelle: Maßeinheit \[sn_prd_pm_uom\] |
| Lead_line_items. ​Work_Notes | Liste, die die für die Lead-Position erstellten Arbeitsnotizen beschreibt. Datentyp: Array von Objekten "work_notes": [ { "author": "String", "date": "String", "text": "String" } ] |
| Lead_line_items. ​Work_Notes. ​Autor | Anwendername der Person, die die zugehörige Arbeitsnotiz erstellt hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​Work_Notes. ​Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Lead_line_items. ​Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Lead_Rating | Bewertung für den Lead, z. B. 100_kalt, 200_warm, 300_hot oder 400_super_hot. Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_Rating" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_Score | Punktzahl für den Lead. Datentyp: Decimal Bereich: 1 bis 100 |
| Lead_Source | Urheber des Leads. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Feld „Lead_Source" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_type | Typ des Leads, z. B. „Neues Geschäft" oder „vorhandenes Geschäft". Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_type" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Middle_Name | Zweiter Vorname des Kontakts für den Lead. Datentyp: Zeichenfolge |
| mobile_phone | Telefonnummer des Kontakts für den Lead. Datentyp: Zeichenfolge |
| Nummer | Eindeutige vom System generierte Nummer des Lead-Datensatzes. Datentyp: Zeichenfolge |
| Other_reason | Zusätzlicher Grund für die Lead-Disqualifizierung. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Eigentümer | Details der Person, die dem Lead zugeordnet ist. Datentyp: Objekt "owner": { "name": "String", "sys_id": "String" } |
| owner.name | Name der Person, die den Lead besitzt. Datentyp: Zeichenfolge |
| Besitzer.sys_ID | SYS_ID des Anwenderdatensatzes der Person, die den Lead besitzt. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Grund | Grund für die Lead-Disqualifizierung, z. B. disqualifizieren. Datentyp: Zeichenfolge Max. Länge: 40 Zeichen |
| short_description | Kurzbeschreibung des Leads. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Similar_Lead | Details zu ähnlichen Leads. Verwenden Sie dies für eine mögliche Lead-Disqualifizierung. Datentyp: Objekt "similar_lead": { "name": "String", "sys_id": "String" } |
| similar_lead.name | Name des doppelten Leads. Datentyp: Zeichenfolge |
| Similar_Lead.sys_ID | SYS_ID des Lead-Datensatzes, der ein möglicher doppelter Lead ist. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| Phase | Phase des Leads, z. B. 100_New. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Phasenfeld der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Staat | Status, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Straße | Straße, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| sys_class_name | Vom System generierter Klassenname der Lead-Tabelle. Datentyp: Zeichenfolge |
| sys_created_by | Anwendername der Person, die den Lead erstellt hat. Datentyp: Zeichenfolge |
| sys_created_on | Vom System generiertes Datum und Uhrzeit der Erstellung des Leads. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| sys_created_on. ​Display_value | Datum und Uhrzeit der Erstellung des Leads. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| sys_created_on. ​Wert | Datum und Uhrzeit der Erstellung des Leads. Datentyp: Zeichenfolge Format: UTC |
| sys_Domain | SYS_ID des Domänendatensatzes, zu dem der Lead gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| sys_Domain_path | Pfad der Domäne, zu der der Lead gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des Lead-Datensatzes. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| sys_mod_count | Gibt an, wie oft der zugeordnete Lead-Datensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| sys_Tags | Liste der System-Tags, die dem Lead zugeordnet sind. Sie können diese Tags verwenden, um Leads zu kategorisieren. Datentyp: Array |
| sys_updated_by | Anwendername der Person, die den Lead-Datensatz zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| sys_updated_on | Vom System generiertes Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| sys_updated_on. ​Display_value | Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Zeichenfolge Format: Standardformat und Zeitzone der Instanz |
| sys_updated_on. ​Wert | Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Zeichenfolge Format: UTC |
| Titel | Titel des Leads. Datentyp: Zeichenfolge |
| Website | Website-URL des Lead. Datentyp: Zeichenfolge |
| Work_Notes | Liste der für den Lead erstellten Arbeitsnotizen. Datentyp: Array von Objekten "work_notes": [ { "author": "String", "date": "String", "text": "String" } ] |
| Work_Notes. ​Autor | Anwendername der Person, die die zugehörige Arbeitsnotiz erstellt hat. Datentyp: Zeichenfolge |
| Work_Notes. ​Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Postleitzahl | Postleitzahl des zugeordneten Leads. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie der Lead-Datensatz mit der sys_ID 856b6a95ffde8210b85dffffffffd7 aktualisiert wird.

    curl " https://instance.service-now.com/api/sn_lead_mgmt_core/v1/lead/856b6a95ffde8210b85dffffffffffd7" \ 
    --request PATCH \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data " {
      "lead_source": "inbount_web",
      "business_phone": "+1 (555) 123-4567",
      "do_not_share": true,
      "lead_score": 40,
      "stage": "300_nurturning",
      "do_not_email": false,
      "lead_type": "new_business",
      "work_notes": [
        {
          "text": "Work notes for lead"
        }
      ],
      "lead_rating": "200_warm",
      "lead_line_items": [
        {
          "sys_id" : "013daa19ffde8210b85dffffffffff82",
          "quantity": 10
        },
        {
          "product_offering": {
            "sys_id": "0b61dd9fd0a63110f8770dbf976be171"
          }
        }
      ]
    }"

Die Antwort enthält alle Lead-Datensatzfelder.

    { 
      "short_description": "Looking for a quote on preventative maintenance plans for their corporate office building elevators.",
      "reason": null,
      "country": "USA",
      "closed_date": null,
      "city": "San Francisco",
      "lead_source": "inbount_web",
      "external_id": null,
      "industry": "manufacturing",
      "sys_updated_on": {
        "value": "2024-12-11 08:45:52",
        "display_value": "2024-12-11 00:45:52"
      },
      "title": "Director of Building operations",
      "sys_class_name": "Lead",
      "number": "LEAD0000001",
      "sys_id": "856b6a95ffde8210b85dffffffffffd7",
      "business_phone": "+1 (555) 123-4567",
      "similar_lead": null,
      "sys_updated_by": "abel.tuter",
      "mobile_phone": null,
      "street": "789, Industrial drive",
      "sys_created_on": {
        "value": "2024-05-20 10:32:41",
        "display_value": "2024-05-20 03:32:41"
      },
      "contact": null,
      "company": "Lee Manufacturing Inc",
      "state": "CA",
      "first_name": "James",
      "email": "james.wilson@email.com",
      "consumer": null,
      "sys_created_by": "abel.tuter",
      "zip": "94016",
      "owner": {
        "sys_id": "60058fe943fe3110d6c6cd60afb8f203",
        "name": "Max Blaze"
      },
      "website": null,
      "lead_group": null,
      "sys_mod_count": 4,
      "last_name": "Wilson",
      "other_reason": null,
      "middle_name": null,
      "sys_tags": null,
      "do_not_share": true,
      "lead_score": 40,
      "stage": "300_nurturing",
      "do_not_email": false,
      "lead_type": "new_business",
      "work_notes": [
        {
          "author": "Abel Tuter",
          "date": "2024-12-11 00:45:52",
          "text": "Lead Line Item [code]<a href='/sn_lead_mgmt_core_lead_line_item.do?sys_id=013daa19ffde8210b85dffffffffff82'>LEADL0000003</a>[/code] has been updated  [code] <b> Quantity </b> [/code] 10 [code] <i>was</i> [/code] 6"
        },
        {
          "author": "Abel Tuter",
          "date": "2024-12-11 00:45:52",
          "text": "Lead Line Item [code]<a href='/sn_lead_mgmt_core_lead_line_item.do?sys_id=37610e1780925210f877983fa0be6725'>LEADL0001002</a>[/code] has been created  [code] <b> Product Offering </b> [/code] Solana Modem M Series [code] <b> Quantity </b> [/code] 1"
        },
        {
          "author": "Abel Tuter",
          "date": "2024-12-11 00:45:51",
          "text": "Work notes for lead"
        }
      ],
      "do_not_call": false,
      "lead_rating": "200_warm",
      "account": null,
      "external_system": null,
      "lead_line_items": [
        {
          "quantity": 10,
          "product_offering": {
            "sys_id": "32619d9fd0a63110f8770dbf976be1f9",
            "name": "Safety Test Coverage",
            "code": "SAFETSTCVG1"
          },
          "sys_mod_count": 1,
          "external_id": null,
          "sys_updated_on": {
            "value": "2024-12-11 08:45:52",
            "display_value": "2024-12-11 00:45:52"
          },
          "sys_tags": null,
          "lead": {
            "sys_id": "856b6a95ffde8210b85dffffffffffd7",
            "name": "LEAD0000001"
          },
          "number": "LEADL0000003",
          "sys_id": "013daa19ffde8210b85dffffffffff82",
          "unit_of_measurement": {
            "sys_id": "cb2795d553020110286eddeeff7b12ff",
            "name": "Each"
          },
          "sys_updated_by": "abel.tuter",
          "sys_created_on": {
            "value": "2024-05-20 10:38:41",
            "display_value": "2024-05-20 03:38:41"
          },
          "work_notes": null,
          "sys_created_by": "abel.tuter",
          "external_system": null
        },
        {
          "quantity": 1,
          "product_offering": {
            "sys_id": "0b61dd9fd0a63110f8770dbf976be171",
            "name": "Solana Modem M Series",
            "code": "SOLANAMODE2"
          },
          "sys_mod_count": 0,
          "external_id": null,
          "sys_updated_on": {
            "value": "2024-12-11 08:45:52",
            "display_value": "2024-12-11 00:45:52"
          },
          "sys_tags": null,
          "lead": {
            "sys_id": "856b6a95ffde8210b85dffffffffffd7",
            "name": "LEAD0000001"
          },
          "number": "LEADL0001002",
          "sys_id": "37610e1780925210f877983fa0be6725",
          "unit_of_measurement": null,
          "sys_updated_by": "abel.tuter",
          "sys_created_on": {
            "value": "2024-12-11 08:45:52",
            "display_value": "2024-12-11 00:45:52"
          },
          "work_notes": null,
          "sys_created_by": "abel.tuter",
          "external_system": null
        }
      ]
    }

## Lead -- POSTEN /sn_lead_mgmt_core/Lead {#ariaid-title5}

Erstellt einen Lead-Datensatz und die zugehörigen Lead-Positionselemente mit den angegebenen Parametern.
Nach der Verarbeitung werden Datensätze in den folgenden Tabellen erstellt:

* Lead \[sn_lead_mgmt_core_lead\]
* Lead-Positionselement \[sn_lead_mgmt_core_lead_line_item\]  
Regeln für übergebene Parameter:

* Ungültige Parameternamen werden ignoriert.
* Ungültige Werte für nicht obligatorische Auswahlfelder und Referenzfelder werden ignoriert.
* Wenn der FELDSCHREIBZUGRIFF für ein oder mehrere Felder verweigert wird, werden die eingeschränkten Felder ignoriert.
* Sie können mit dieser API keine Systemfeldwerte einfügen. Alle angegebenen Werte werden ignoriert. Systemfelder sind Teil der Liste „ignorierte Felder", die konfigurierbar ist.
* Die Werte der Parameter account, contact, Und consumerWerden ignoriert, wenn beide verwendet werden accountUnd consumerParameter sind nicht leer.
* Sofern nicht anders angegeben, ist der Standardwert für alle nicht übergebenen Parameter „null".

### URL-Format

Versionierte URL: /api/sn_lead_mgmt_core/{api_Version}/Lead

Standard-URL: /api/sn_lead_mgmt_core/{api_Version}/Lead  
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

{#lead-POST-lead__entry__2}{#lead-POST-lead__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 : 19. Pfad-Parameter]

{#lead-POST-lead__entry__6}

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

{#lead-POST-lead__entry__10}{#lead-POST-lead__lead-account-entry}{#lead-POST-lead__lead-account.sys_id-entry}{#lead-POST-lead__lead-business_phone-entry}{#lead-POST-lead__lead-city-entry}{#lead-POST-lead__lead-company-entry}{#lead-POST-lead__lead-consumer.sys_id-entry}{#lead-POST-lead__lead-contact.sys_id-entry}{#lead-POST-lead__lead-country-entry}{#lead-POST-lead__lead-email-entry}{#lead-POST-lead__lead-external_id-entry}{#lead-POST-lead__lead-external_system-entry}{#lead-POST-lead__lead-first_name-entry}{#lead-POST-lead__lead-industry-entry}{#lead-POST-lead__lead-lead_group.sys_id-entry}{#lead-POST-lead__lead-lead_line_items.external_id-entry}{#lead-POST-lead__lead-lead_line_items.external_system-entry}{#lead-POST-lead__lead-lead_line_items.unit_of_measurement.sys_id-entry}{#lead-POST-lead__lead-lead_line_items.work_notes.text-entry}{#lead-POST-lead__lead-lead_rating-entry}{#lead-POST-lead__lead-lead_score-entry}{#lead-POST-lead__lead-lead_source-entry}{#lead-POST-lead__lead-lead_type-entry}{#lead-POST-lead__lead-middle_name-entry}{#lead-POST-lead__lead-mobile_phone-entry}{#lead-POST-lead__lead-other_reason-entry}{#lead-POST-lead__lead-owner.sys_id-entry}{#lead-POST-lead__lead-reason-entry}{#lead-POST-lead__lead-short_description-entry}{#lead-POST-lead__lead-similar_lead.sys_id-entry}{#lead-POST-lead__lead-state-entry}{#lead-POST-lead__lead-street-entry}{#lead-POST-lead__lead-title-entry}{#lead-POST-lead__lead-website-entry}{#lead-POST-lead__lead-work_notes.text-entry}{#lead-POST-lead__lead-zip-entry}

| Name | Beschreibung |
|-|-|
| Account | Details zum Account, der dem Lead zugeordnet ist. Datentyp: Objekt "account": { "sys_id": "String" } |
| Account.sys_ID | SYS_ID des zugeordneten Account-Datensatzes. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\] |
| business_phone | Geschäftliche Telefonnummer des Leads. Datentyp: Zeichenfolge |
| city | Stadt, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| Unternehmen | Unternehmensname des Leads. Datentyp: Zeichenfolge |
| consumer | Verbraucher, der dem Lead zugeordnet ist. Datentyp: Objekt "consumer": { "sys_id": "String" } |
| Consumer.sys_ID | SYS_ID des zugeordneten Verbraucherdatensatzes. Datentyp: Zeichenfolge Tabelle: Verbraucher \[csm_Consumer\] |
| Kontakt | Kontakt, der dem Lead-Account zugeordnet ist. Datentyp: Objekt "contact": { "sys_id": "String" } |
| Contact.sys_ID | SYS_ID des zugeordneten Kontaktdatensatzes. Datentyp: Zeichenfolge Tabelle: Kontakt \[Customer_contact\] |
| country | Land, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Do_Not_Call | Kennzeichnung, die angibt, ob der Kommunikationsmodus per Telefon erfolgt. Gültige Werte: * Wahr: Kann Kontakt anrufen. * Falsch: Kontakt nicht anrufen. Datentyp: Boolescher Wert Standard: Falsch |
| Do_Not_email | Kennzeichnung, die angibt, ob der Kommunikationsmodus per E-Mail erfolgt. Gültige Werte: * Wahr: Kann Kontakt per E-Mail senden. * Falsch: Senden Sie keine E-Mail an den Kontakt. Datentyp: Boolescher Wert Standard: Falsch |
| Nicht_freigeben | Kennzeichnung, die angibt, ob die Lead-Details freigegeben werden können. Gültige Werte: * Wahr: Lead-Details können freigegeben werden. * Falsch: Lead-Details können nicht geteilt werden. Datentyp: Boolescher Wert Standard: Falsch |
| E-Mail | E-Mail-Adresse des Leads. Datentyp: Zeichenfolge |
| external_id | ID, die vom System verwendet wird, das den Lead generiert hat, um den Lead im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| External_System | Name des externen Systems, das dem Lead zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| first_name | Vorname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Branche | Branche, zu der der Lead gehört. Datentyp: Zeichenfolge Tabelle: Befindet sich in industryFeld der Account-Tabelle \[Customer_Account\]. |
| last_name | Erforderlich. Nachname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Lead_Group | Gruppe, zu der der Lead gehört. Datentyp: Objekt "lead_group": { "sys_id": "String" } |
| Lead_Group.sys_ID | SYS_ID des Lead-Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| Lead_line_items | Liste der Lead-Positionselemente, die dem Lead zugeordnet werden sollen. Gruppe, zu der der Lead gehört. Datentyp: Objekt "lead_line_items": [ { "external_id": "String", "external_system": "String", "product_offering": {Object}, "quantity": Number, "work_notes": [Array], "unit_of_measurement": {Object} } ] Maximale Anzahl von Einzelposten: 100 -- alle über, die ignoriert werden |
| Lead_line_items. ​External_ID | ID, die vom System verwendet wird, das die Lead-Position generiert hat, um die Position im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| Lead_line_items. ​External_System | Name des externen Systems, das dem Lead-Positionselement zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| lead_line_items.product_offering | Erforderlich. Informationen zum Produktangebot, das der Lead-Position zugeordnet ist. Datentyp: Objekt "product_offering": { "sys_id": "String" } |
| lead_line_items.product_offering.sys_id | Erforderlich. SYS_ID des Produktangebotsdatensatzes, der der Lead-Position zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| Lead_line_items.quantity | Menge der Artikel, die der Lead des zugehörigen Produktangebots kaufen möchte. Datentyp: Zahl (Ganzzahl) Standard: 1 |
| lead_line_items.unit_of_measurement | Details der Maßeinheit des Lead-Positionselements. Datentyp: Objekt "unit_of_measurement": { "sys_id": "String" } |
| Lead_line_items. ​Unit_of_Measurement. ​sys_ID | SYS_ID des Datensatzes, der die Maßeinheit beschreibt. Datentyp: Zeichenfolge Tabelle: Maßeinheit \[sn_prd_pm_uom\] |
| lead_line_items.work_notes | Liste, die die für die Lead-Position erstellten Arbeitsnotizen beschreibt. Datentyp: Array von Objekten "work_notes": [ "text": "String" } ] Standard: Leeres Array |
| Lead_line_items. ​Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Lead_Rating | Bewertung für den Lead, z. B. 100_kalt, 200_warm, 300_hot oder 400_super_hot. Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_Rating" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_Score | Punktzahl für den Lead. Datentyp: Decimal Bereich: 1 bis 100 |
| Lead_Source | Urheber des Leads. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Feld „Lead_Source" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_type | Typ des Leads, z. B. „Neues Geschäft" oder „vorhandenes Geschäft". Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_type" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Middle_Name | Zweiter Vorname des Kontakts für den Lead. Datentyp: Zeichenfolge |
| mobile_phone | Telefonnummer des Kontakts für den Lead. Datentyp: Zeichenfolge |
| Other_reason | Zusätzlicher Grund für die Lead-Disqualifizierung. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Eigentümer | Details der Person, die dem Lead zugeordnet ist. Datentyp: Objekt "owner": { "sys_id": "String" } |
| Besitzer.sys_ID | SYS_ID des Anwenderdatensatzes der Person, die den Lead besitzt. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Grund | Grund für die Lead-Disqualifizierung, z. B. disqualifizieren. Datentyp: Zeichenfolge Max. Länge: 40 Zeichen |
| short_description | Kurzbeschreibung des Leads. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Similar_Lead | Details zu ähnlichen Leads. Verwenden Sie dies für eine mögliche Lead-Disqualifizierung. Datentyp: Objekt "similar_lead": { "sys_id": "String" } |
| Similar_Lead.sys_ID | SYS_ID des Lead-Datensatzes, der ein möglicher doppelter Lead ist. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| Phase | Phase des Leads, z. B. 100_New. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Phasenfeld der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge Standard: 100_New |
| Staat | Status, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Straße | Straße, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| Titel | Titel des Leads. Datentyp: Zeichenfolge |
| Website | Website-URL des Lead. Datentyp: Zeichenfolge |
| Work_Notes | Liste der für den Lead erstellten Arbeitsnotizen. Datentyp: Array von Objekten "work_notes": [ { "text": "String" } ] Hinweis: Ein Array von Arbeitsnotizen in der Anforderung wird als einzelner Text eingefügt. Dieser Text wird generiert, indem der Inhalt aus allen Arbeitsnotizobjekten in der Anforderung kombiniert wird, wobei jeder Eintrag durch ein Komma (,) getrennt wird. Standard: Leeres Array |
| Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Postleitzahl | Postleitzahl des zugeordneten Leads. Datentyp: Zeichenfolge |
[Tabelle : 21. Anforderungstext-Parameter]

### 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.").
{#lead-POST-lead__entry__116}{#lead-POST-lead__accept-JSON-only-entry-RESTAPI}

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

{#lead-POST-lead__entry__120}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. 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.").
{#lead-POST-lead__entry__124}{#lead-POST-lead__lead-400-status_code-entry}{#lead-POST-lead__entry-403-status-code}{#lead-POST-lead__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 201 | Erfolgreich. Lead und die zugehörigen Einzelposten wurden erfolgreich eingefügt. |
| 400 | Fehler. Mögliche Gründe: * Ungültige Nutzlast: Ungültiger/leerer Anforderungstext. * Ungültige Nutzlast: Ungültiger Feldwert für E-Mail-/Telefonnummernfelder. * Ungültige Nutzlast: Pflichtfeld fehlt, oder sein Wert ist leer. * Verstoß gegen Business-Regel/Datenrichtlinie. |
| 403 | Unzulässig. Der Anwender hat keine Zugriffsrechte für den angegebenen Datensatz. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter

{#lead-POST-lead__entry__134}{#lead-POST-lead__d3520e70}{#lead-POST-lead__lead-account.name-entry}{#lead-POST-lead__d3520e94}{#lead-POST-lead__d3520e111}{#lead-POST-lead__d3520e122}{#lead-POST-lead__lead-closed_date-ph}{#lead-POST-lead__lead-closed_date.display_value-entry}{#lead-POST-lead__lead-closed_date.value-entry}{#lead-POST-lead__d3520e174}{#lead-POST-lead__lead-consumer-ph}{#lead-POST-lead__lead-consumer.name-entry}{#lead-POST-lead__d3520e211}{#lead-POST-lead__lead-contact-ph}{#lead-POST-lead__lead-contact.name-entry}{#lead-POST-lead__d3520e253}{#lead-POST-lead__d3520e270}{#lead-POST-lead__lead-do_not_call-entry}{#lead-POST-lead__lead-do_not_email-entry}{#lead-POST-lead__lead-do_not_share-entry}{#lead-POST-lead__d3520e354}{#lead-POST-lead__d3520e365}{#lead-POST-lead__d3520e376}{#lead-POST-lead__d3520e387}{#lead-POST-lead__d3520e399}{#lead-POST-lead__lead-last_name-entry}{#lead-POST-lead__lead-lead_group-entry}{#lead-POST-lead__lead-lead_group.name-entry}{#lead-POST-lead__d3520e457}{#lead-POST-lead__lead-lead_line_items-entry}{#lead-POST-lead__d3520e484}{#lead-POST-lead__d3520e495}{#lead-POST-lead__lead-lead_line_items.lead-entry}{#lead-POST-lead__lead-lead_line_items.lead.name-entry}{#lead-POST-lead__lead-lead_line_items.lead.sys_id-entry}{#lead-POST-lead__lead-lead_line_items.number-entry}{#lead-POST-lead__lead-lead_line_items.product_offering-ph}{#lead-POST-lead__lead-lead_line_items.product_offering.code-entry}{#lead-POST-lead__lead-lead_line_items.product_offering.name-entry}{#lead-POST-lead__lead-lead_line_items.product_offering.sys_id-entry}{#lead-POST-lead__lead-lead_line_items.quantity-entry}{#lead-POST-lead__lead-lead_line_items.sys_created_by-entry}{#lead-POST-lead__lead-lead_line_items.sys_created_on-entry}{#lead-POST-lead__lead-lead_line_items.sys_created_on.display_value-entry}{#lead-POST-lead__lead-lead_line_items.sys_created_on.value-entry}{#lead-POST-lead__lead-lead_line_items.sys_domain-entry}{#lead-POST-lead__lead-lead_line_items.sys_domain_path-entry}{#lead-POST-lead__lead-lead_line_items.sys_id-entry}{#lead-POST-lead__lead-lead_line_items.sys_mod_count-entry}{#lead-POST-lead__lead-lead_line_items.sys_tags-entry}{#lead-POST-lead__lead-lead_line_items.sys_updated_by-entry}{#lead-POST-lead__lead-lead_line_items.sys_updated_on-entry}{#lead-POST-lead__lead-lead_line_items.sys_updated_on.display_value-entry}{#lead-POST-lead__lead-lead_line_items.sys_updated_on.value-entry}{#lead-POST-lead__lead-lead_line_items.unit_of_measurement-entry}{#lead-POST-lead__lead-lead_line_items.unit_of_measurement.name-entry}{#lead-POST-lead__d3520e812}{#lead-POST-lead__lead-lead_line_items.work_notes-entry}{#lead-POST-lead__lead-lead_line_items.work_notes.author-entry}{#lead-POST-lead__lead-lead_line_items.work_notes.date-entry}{#lead-POST-lead__d3520e865}{#lead-POST-lead__d3520e876}{#lead-POST-lead__d3520e889}{#lead-POST-lead__d3520e902}{#lead-POST-lead__d3520e915}{#lead-POST-lead__d3520e933}{#lead-POST-lead__d3520e945}{#lead-POST-lead__lead-number-entry}{#lead-POST-lead__d3520e967}{#lead-POST-lead__lead-owner-entry}{#lead-POST-lead__lead-owner.name-entry}{#lead-POST-lead__d3520e1008}{#lead-POST-lead__d3520e1022}{#lead-POST-lead__d3520e1035}{#lead-POST-lead__lead-similar_lead-entry}{#lead-POST-lead__lead-similar_lead.name-entry}{#lead-POST-lead__d3520e1076}{#lead-POST-lead__lead-stage-entry}{#lead-POST-lead__d3520e1106}{#lead-POST-lead__d3520e1117}{#lead-POST-lead__lead-sys_class_name-entry}{#lead-POST-lead__lead-sys_created_by-entry}{#lead-POST-lead__lead-sys_created_on-entry}{#lead-POST-lead__lead-sys_created_on.display_value-entry}{#lead-POST-lead__lead-sys_created_on.value-entry}{#lead-POST-lead__lead-sys_domain-entry}{#lead-POST-lead__lead-sys_domain_path-entry}{#lead-POST-lead__lead-sys_id-entry}{#lead-POST-lead__lead-sys_mod_count-entry}{#lead-POST-lead__lead-sys_tags-entry}{#lead-POST-lead__lead-sys_updated_by-entry}{#lead-POST-lead__lead-sys_updated_on-entry}{#lead-POST-lead__lead-sys_updated_on.display_value-entry}{#lead-POST-lead__lead-sys_updated_on.value-entry}{#lead-POST-lead__d3520e1302}{#lead-POST-lead__d3520e1313}{#lead-POST-lead__lead-work_notes-entry}{#lead-POST-lead__lead-work_notes.author-entry}{#lead-POST-lead__lead-work_notes.date-entry}{#lead-POST-lead__d3520e1364}{#lead-POST-lead__d3520e1375}

| Name | Beschreibung |
|-|-|
| Account | Account, der mit dem Lead verknüpft ist. Datentyp: Objekt "account": { "name": "String", "sys_id": "String" } |
| account.name | Name des Accounts. Datentyp: Zeichenfolge |
| Account.sys_ID | SYS_ID des zugeordneten Account-Datensatzes. Datentyp: Zeichenfolge Tabelle: Account \[Customer_Account\] |
| business_phone | Geschäftliche Telefonnummer des Leads. Datentyp: Zeichenfolge |
| city | Stadt, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| Closed_date | Datum und Uhrzeit der Schließung des Leads. Datentyp: Objekt "closed_date": { "display_value": "String", "value": "String" } |
| Closed_date. ​Display_value | Datum und Uhrzeit wie in der Anwenderoberfläche angezeigt. Datentyp: Zeichenfolge Format: Format und Zeitzone des Anwenders. |
| Closed_date.value | Datum und Uhrzeit, zu der der Lead geschlossen wurde, wie im zugehörigen Datensatz definiert. Datentyp: Zeichenfolge Format: UTC |
| Unternehmen | Unternehmensname des Leads. Datentyp: Zeichenfolge |
| consumer | Verbraucher, der dem Lead zugeordnet ist. Datentyp: Objekt "consumer": { "name": "String", "sys_id": "String" } |
| consumer.name | Name des zugeordneten Verbrauchers. Datentyp: Zeichenfolge |
| Consumer.sys_ID | SYS_ID des zugeordneten Verbraucherdatensatzes. Datentyp: Zeichenfolge Tabelle: Verbraucher \[csm_Consumer\] |
| Kontakt | Kontakt, der dem Lead-Account zugeordnet ist. Datentyp: Objekt "contact": { "name": "String", "sys_id": "String" } |
| contact.name | Name des Kontakts. Datentyp: Zeichenfolge |
| Contact.sys_ID | SYS_ID des zugeordneten Kontaktdatensatzes. Datentyp: Zeichenfolge Tabelle: Kontakt \[Customer_contact\] |
| country | Land, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Do_Not_Call | Kennzeichnung, die angibt, ob der Kommunikationsmodus per Telefon erfolgt. Gültige Werte: * Wahr: Kann Kontakt anrufen. * Falsch: Kontakt nicht anrufen. Datentyp: Boolescher Wert |
| Do_Not_email | Kennzeichnung, die angibt, ob der Kommunikationsmodus per E-Mail erfolgt. Gültige Werte: * Wahr: Kann Kontakt per E-Mail senden. * Falsch: Senden Sie keine E-Mail an den Kontakt. Datentyp: Boolescher Wert |
| Nicht_freigeben | Kennzeichnung, die angibt, ob die Lead-Details freigegeben werden können. Gültige Werte: * Wahr: Lead-Details können freigegeben werden. * Falsch: Lead-Details können nicht geteilt werden. Datentyp: Boolescher Wert |
| E-Mail | E-Mail-Adresse des Leads. Datentyp: Zeichenfolge |
| external_id | ID, die vom System verwendet wird, das den Lead generiert hat, um den Lead im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| External_System | Name des externen Systems, das dem Lead zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| first_name | Vorname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Branche | Branche, zu der der Lead gehört. Datentyp: Zeichenfolge Tabelle: Befindet sich in industryFeld der Account-Tabelle \[Customer_Account\]. |
| last_name | Nachname des Kontakts, der dem Lead zugeordnet ist. Datentyp: Zeichenfolge |
| Lead_Group | Gruppe, zu der der Lead gehört. Datentyp: Objekt "lead_group": { "name: "String", "sys_id": "String" } |
| lead_group.name | Name der Lead-Gruppe. Datentyp: Zeichenfolge |
| Lead_Group.sys_ID | SYS_ID des Lead-Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| Lead_line_items | Details der Lead-Positionselemente, die dem Lead zugeordnet sind. Datentyp: Array von Objekten "lead_line_items": [ { "external_id": "String", "external_system": "String", "lead": {Object}, "number": "String", "product_offering": {Object}, "quantity": Number, "sys_created_by": "String", "sys_created_on {Object}, "sys_domain": "String", "sys_domain_path": "String", "sys_id": "String", "sys_mod_count": Number, "sys_tags": [Array], "sys_updated_by: "String", "sys_updated_on: {Object}, "unit_of_measurement": {Object}, "work_notes": [Array] } ] |
| Lead_line_items. ​External_ID | ID, die vom System verwendet wird, das die Lead-Position generiert hat, um die Position im zugehörigen System zu identifizieren. Datentyp: Zeichenfolge |
| Lead_line_items. ​External_System | Name des externen Systems, das dem Lead-Positionselement zugeordnet ist, z. B. HubSpot oder pipedrive. Datentyp: Zeichenfolge |
| Lead_line_items. ​Lead | Details zum Lead, der der Position zugeordnet ist. Datentyp: Objekt "lead: { "name": "String", "sys_id": "String" } |
| Lead_line_items. ​lead.name | Name des zugeordneten Leads. Datentyp: Zeichenfolge |
| Lead_line_items. ​Lead.sys_ID | SYS_ID des zugeordneten Lead-Datensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​Nummer | Eindeutige vom System generierte Nummer des Lead-Positionselementdatensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​Product_Offering | Informationen zum Produktangebot, das der Lead-Position zugeordnet ist. Datentyp: Objekt "product_offering": { "code": " String", "name": "String", "sys_id": "String" } |
| Lead_line_items. ​Product_offering.Code | Code, der mit dem Produktangebot verknüpft ist. Hinweis: Dies ist eine vom System generierte alphanumerische Nummer basierend auf dem Produktnamen. Obwohl vom System generiert, können Sie den Code bearbeiten, um eine SKU oder andere branchenspezifische Produktcodes darzustellen. Datentyp: Zeichenfolge |
| Lead_line_items. ​product_offering.name | Name des Produktangebots. Datentyp: Zeichenfolge |
| Lead_line_items. ​Product_Offering.sys_ID | SYS_ID des Produktangebotsdatensatzes, der der Lead-Position zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
| Lead_line_items. ​Menge | Menge der Artikel, die der Lead des zugehörigen Produktangebots kaufen möchte. Datentyp: Zahl (Ganzzahl) |
| Lead_line_items. ​sys_created_by | Anwendername der Person, die die Lead-Position erstellt hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_created_on | Vom System generiertes Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| Lead_line_items. ​sys_created_on.display_value | Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| Lead_line_items. ​sys_created_on.value | Datum und Uhrzeit der Erstellung des Lead-Positionselements. Datentyp: Zeichenfolge Format: UTC |
| Lead_line_items. ​sys_Domain | SYS_ID des Domänendatensatzes, zu dem das Lead-Positionselement gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| lead_line_items.sys_domain_path | Pfad der Domäne, zu der das Lead-Positionselement gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_ID | SYS_ID des Lead-Positionselementdatensatzes. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_mod_count | Gibt an, wie oft der zugehörige Lead-Positionselementdatensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| Lead_line_items. ​sys_Tags | Liste der System-Tags, die dem Lead-Positionselement zugeordnet sind. Datentyp: Array |
| Lead_line_items. ​sys_updated_by | Anwendername der Person, die die zugehörige Lead-Position zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​sys_updated_on | Vom System generiertes Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| Lead_line_items. ​sys_updated_on. ​Display_value | Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| Lead_line_items. ​sys_updated_on. ​Wert | Datum und Uhrzeit der letzten Aktualisierung des Lead-Positionselements. Datentyp: Zeichenfolge Format: UTC |
| Lead_line_items. ​Unit_of_Measurement | Details der Maßeinheit des Lead-Positionselements. Datentyp: Objekt "unit_of_measurement": { "name": "String", "sys_id": "String" } |
| Lead_line_items. ​Unit_of_Measurement. ​Name | Name der Maßeinheit, z. B. „einzeln" oder „Kubikfuß". Datentyp: Zeichenfolge |
| Lead_line_items. ​Unit_of_Measurement. ​sys_ID | SYS_ID des Datensatzes, der die Maßeinheit beschreibt. Datentyp: Zeichenfolge Tabelle: Maßeinheit \[sn_prd_pm_uom\] |
| Lead_line_items. ​Work_Notes | Liste, die die für die Lead-Position erstellten Arbeitsnotizen beschreibt. Datentyp: Array von Objekten "work_notes": [ { "author": "String", "date": "String", "text": "String" } ] |
| Lead_line_items. ​Work_Notes. ​Autor | Anwendername der Person, die die zugehörige Arbeitsnotiz erstellt hat. Datentyp: Zeichenfolge |
| Lead_line_items. ​Work_Notes. ​Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Lead_line_items. ​Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Lead_Rating | Bewertung für den Lead, z. B. 100_kalt, 200_warm, 300_hot oder 400_super_hot. Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_Rating" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_Score | Punktzahl für den Lead. Datentyp: Decimal Bereich: 1 bis 100 |
| Lead_Source | Urheber des Leads. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Feld „Lead_Source" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Lead_type | Typ des Leads, z. B. „Neues Geschäft" oder „vorhandenes Geschäft". Hinweis: Dies ist ein Auswahlfeld. Es muss eines der Auswahlelemente enthalten, die im Feld „Lead_type" der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Middle_Name | Zweiter Vorname des Kontakts für den Lead. Datentyp: Zeichenfolge |
| mobile_phone | Telefonnummer des Kontakts für den Lead. Datentyp: Zeichenfolge |
| Nummer | Eindeutige vom System generierte Nummer des Lead-Datensatzes. Datentyp: Zeichenfolge |
| Other_reason | Zusätzlicher Grund für die Lead-Disqualifizierung. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Eigentümer | Details der Person, die dem Lead zugeordnet ist. Datentyp: Objekt "owner": { "name": "String", "sys_id": "String" } |
| owner.name | Name der Person, die den Lead besitzt. Datentyp: Zeichenfolge |
| Besitzer.sys_ID | SYS_ID des Anwenderdatensatzes der Person, die den Lead besitzt. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Grund | Grund für die Lead-Disqualifizierung, z. B. disqualifizieren. Datentyp: Zeichenfolge Max. Länge: 40 Zeichen |
| short_description | Kurzbeschreibung des Leads. Datentyp: Zeichenfolge Max. Länge: 160 Zeichen |
| Similar_Lead | Details zu ähnlichen Leads. Verwenden Sie dies für eine mögliche Lead-Disqualifizierung. Datentyp: Objekt "similar_lead": { "name": "String", "sys_id": "String" } |
| similar_lead.name | Name des doppelten Leads. Datentyp: Zeichenfolge |
| Similar_Lead.sys_ID | SYS_ID des Lead-Datensatzes, der ein möglicher doppelter Lead ist. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| Phase | Phase des Leads, z. B. 100_New. Hinweis: Dies ist ein Auswahlfeld. Sie muss eines der Auswahlelemente enthalten, die im Phasenfeld der Leads-Tabelle definiert sind. Datentyp: Zeichenfolge |
| Staat | Status, in dem sich der Lead befindet. Datentyp: Zeichenfolge |
| Straße | Straße, in der sich der Lead befindet. Datentyp: Zeichenfolge |
| sys_class_name | Vom System generierter Klassenname der Lead-Tabelle. Datentyp: Zeichenfolge |
| sys_created_by | Anwendername der Person, die den Lead erstellt hat. Datentyp: Zeichenfolge |
| sys_created_on | Vom System generiertes Datum und Uhrzeit der Erstellung des Leads. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| sys_created_on. ​Display_value | Datum und Uhrzeit der Erstellung des Leads. Datentyp: Zeichenfolge Format: Standardinstanzformat und Zeitzone |
| sys_created_on. ​Wert | Datum und Uhrzeit der Erstellung des Leads. Datentyp: Zeichenfolge Format: UTC |
| sys_Domain | SYS_ID des Domänendatensatzes, zu dem der Lead gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| sys_Domain_path | Pfad der Domäne, zu der der Lead gehört. Hinweis: Dieser Parameter wird nur in der Antwort zurückgegeben, wenn die Domänentrennung aktiviert ist. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des Lead-Datensatzes. Datentyp: Zeichenfolge Tabelle: Lead \[sn_lead_mgmt_core_lead\] |
| sys_mod_count | Gibt an, wie oft der zugeordnete Lead-Datensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| sys_Tags | Liste der System-Tags, die dem Lead zugeordnet sind. Sie können diese Tags verwenden, um Leads zu kategorisieren. Datentyp: Array |
| sys_updated_by | Anwendername der Person, die den Lead-Datensatz zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| sys_updated_on | Vom System generiertes Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Objekt "sys_created_on": { "display_value": "String", "value": "String" } |
| sys_updated_on. ​Display_value | Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Zeichenfolge Format: Standardformat und Zeitzone der Instanz |
| sys_updated_on. ​Wert | Datum und Uhrzeit der letzten Aktualisierung des Leads. Datentyp: Zeichenfolge Format: UTC |
| Titel | Titel des Leads. Datentyp: Zeichenfolge |
| Website | Website-URL des Lead. Datentyp: Zeichenfolge |
| Work_Notes | Liste der für den Lead erstellten Arbeitsnotizen. Datentyp: Array von Objekten "work_notes": [ { "author": "String", "date": "String", "text": "String" } ] |
| Work_Notes. ​Autor | Anwendername der Person, die die zugehörige Arbeitsnotiz erstellt hat. Datentyp: Zeichenfolge |
| Work_Notes. ​Datum | Datum, an dem die Notiz erstellt wurde. Datentyp: Zeichenfolge |
| Work_Notes. ​Text | Text der Notiz des Autors. Datentyp: Zeichenfolge |
| Postleitzahl | Postleitzahl des zugeordneten Leads. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie ein neuer Lead-Datensatz mit einer Lead-Position erstellt wird.

    curl " https://instance.service-now.com/api/sn_lead_mgmt_core/v1/lead" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data " {
        "short_description": "Looking for a quote on preventative maintenance plans for their corporate office building elevators.",
        "country": "USA",
        "city": "San Francisco",
        "lead_source": "inbound_phone",
        "industry": "manufacturing",
        "title": "Director of Building operations",
        "business_phone": "+1 (555) 123-4567",
        "street": "789, Industrial drive",
        "company": "Lee Manufacturing Inc",
        "state": "CA",
        "first_name": "James",
        "email": "james.wilson@email.com",
        "consumer": {
          "sys_id": "46ce64ef99ca5210f8779c3cc41bb03c"
        },
        "zip": "94016",
        "website": "example.com",
        "last_name": "Wilson",
        "middle_name": null,
        "do_not_share": false,
        "lead_score": 92,
        "stage": "100_new",
        "do_not_email": false,
        "lead_type": "existing_business",
        "work_notes": [
          {
            "text": "Work notes for lead"
          }
        ],
        "do_not_call": true,
        "lead_rating": "200_warm",
        "lead_line_items": [
          {
            "quantity": 1,
            "product_offering": {
              "sys_id": "32619d9fd0a63110f8770dbf976be1f9"
            },
            "unit_of_measurement": { 
              "sys_id": "cb2795d553020110286eddeeff7b12ff"
            }
          }
      ]
    }

Die Antwort enthält die Felder in den Datensätzen der Lead- und Lead-Positionselemente.

    {
      "short_description": "Looking for a quote on preventative maintenance plans for their corporate office building elevators.",
      "reason": null,
      "country": "USA",
      "closed_date": null,
      "city": "San Francisco",
      "lead_source": "inbound_phone",
      "external_id": null,
      "industry": "manufacturing",
      "sys_updated_on": {
        "value": "2024-12-11 08:35:26",
        "display_value": "2024-12-11 00:35:26"
      },
      "title": "Director of Building operations",
      "sys_class_name": "Lead",
      "number": "LEAD0001001",
      "sys_id": "030f795380925210f877983fa0be67c0",
      "business_phone": "+1 (555) 123-4567",
      "similar_lead": null,
      "sys_updated_by": "abel.tuter",
      "mobile_phone": null,
      "street": "789, Industrial drive",
      "sys_created_on": {
        "value": "2024-12-11 08:35:26",
        "display_value": "2024-12-11 00:35:26"
      },
      "contact": null,
      "company": "Lee Manufacturing Inc",
      "state": "CA",
      "first_name": "James",
      "email": "james.wilson@email.com",
      "consumer": {
        "sys_id": "46ce64ef99ca5210f8779c3cc41bb03c",
        "name": "test"
      },
      "sys_created_by": "abel.tuter",
      "zip": "94016",
      "owner": {
        "sys_id": "62826bf03710200044e0bfc8bcbe5df1",
        "name": "Abel Tuter"
      },
      "website": "example.com",
      "lead_group": null,
      "sys_mod_count": 1,
      "last_name": "Wilson",
      "other_reason": null,
      "middle_name": null,
      "sys_tags": null,
      "do_not_share": false,
      "lead_score": 92,
      "stage": "100_new",
      "do_not_email": false,
      "lead_type": "existing_business",
      "work_notes": [
        {
          "author": "Abel Tuter",
          "date": "2024-12-11 00:35:26",
          "text": "Work notes for lead"
        },
        {
          "author": "Abel Tuter",
          "date": "2024-12-11 00:35:26",
          "text": "Lead Line Item [code]<a href='/sn_lead_mgmt_core_lead_line_item.do?sys_id=830f795380925210f877983fa0be67c5'>LEADL0001001</a>[/code] has been created  [code] <b> Product Offering </b> [/code] Safety Test Coverage [code] <b> Quantity </b> [/code] 1 [code] <b> Unit of Measure </b> [/code] Each"
        }
      ],
      "do_not_call": true,
      "lead_rating": "200_warm",
      "account": null,
      "external_system": null,
      "lead_line_items": [
        {
          "quantity": 1,
          "product_offering": {
            "sys_id": "32619d9fd0a63110f8770dbf976be1f9",
            "name": "Safety Test Coverage",
            "code": "SAFETSTCVG1"
          },
          "sys_mod_count": 0,
          "external_id": null,
          "sys_updated_on": {
            "value": "2024-12-11 08:35:26",
            "display_value": "2024-12-11 00:35:26"
          },
          "sys_tags": null,
          "lead": {
            "sys_id": "030f795380925210f877983fa0be67c0",
            "name": "LEAD0001001"
          },
          "number": "LEADL0001001",
          "sys_id": "830f795380925210f877983fa0be67c5",
          "unit_of_measurement": {
            "sys_id": "cb2795d553020110286eddeeff7b12ff",
            "name": "Each"
          },
          "sys_updated_by": "abel.tuter",
          "sys_created_on": {
            "value": "2024-12-11 08:35:26",
            "display_value": "2024-12-11 00:35:26"
          },
          "work_notes": null,
          "sys_created_by": "abel.tuter",
          "external_system": null
        }
      ]
    }


