Dieser Artikel könnte ebenfalls für dich interessant sein:
Kontakte auflisten (REST API)
Kontakt und Ansprechpartner anlegen
POST auf api/mixed
Sind Nachname und Organisation gefüllt, so werden ein Kontakt (die Organisation / das Unternehmen) und ein Ansprechpartner angelegt. Ansonsten wird nur ein Kontakt angelegt.
Werden Kontakt und Ansprechpartner angelegt, so werden die Kommunikationsdaten und die Merkmale beim Ansprechpartner hinterlegt.
Rückgabewert: Die ID des neu angelegten Kontaktes (beginnt mit "C" bei Kontakt und "P" bei Ansprechpartner). Diese ID kann bei weiteren Aufrufen, z.B. dem Anlegen einer Aufgabe, im Feld ContactId übergeben werden.
Beispiel JSON Body:
{
"Gender":null,
"Title":null,
"FirstName":"Johannes",
"LastName":"Geyer",
"Organization":"Große Firma",
"Organization2":null,
"Organization3":null,
"Department":null,
"Position":null,
"Salutation":null,
"TextSalutation":null,
"Birthday":null,
"AccountManager":null,
"AccountManagerId":null,
"CustomerNo":null,
"VATIDNumber":null,
"MainCategory":"Kunde",
"Tags":[
"Golf",
"Hockey"
],
"BlockedForMailingList":null,
"Address":{
"Street":null,
"ZipCode":null,
"City":"Lindelburg",
"State":null,
"Country":null,
"MailBox":null,
"MailBoxZipCode":null,
"AddressType":null
},
"CustomField":{
"TextFeld":"Mit Inhalt",
"ZweitesFeld":"Im zweiten Feld"
},
"Communication":{
"PhoneMobile":"01791141988",
"EMailAddress":"test@test.de"
}
}
Felder, die nicht gefüllt werden sollen, können weggelassen werden im JSON.
| Feld | Typ | Bedeutung |
| Gender | Enum |
Wird das Geschlecht nicht definiert, so versucht D&P anhand des Vornamens und der Anrede das Geschlecht zu erkennen. Mögliche Werte: |
| Salutation | Text | Die Anrede auf dem Briefumschlag. Normalerweise "Herrn" oder "Frau" Wird die Anrede nicht übergeben, so wird sie automatisch von D&P gefüllt. |
| TextSalutation | Text | Die Anrede am Anfang eines Briefes, z.B. "Sehr geehrter Herr Müller" Wird die Briefanrede nicht übergeben, so wird sie automatisch von D&P gefüllt. |
| AccountManager AccountManagerId | Text ID |
Der Betreuer der Adresse. Es kann entweder die ID des Benutzers übergeben werden (in AccountManagerId) oder die E-Mail-Adresse (in AccountManager). |
| CustomerNo | Text | Die Kundennummer oder Lieferantennummer. Ist in den Einstellungen konfiguriert, dass diese automatisch vergeben werden (Default), so geschieht das auch beim Anlegen eines Kontaktes über die API. |
| BlockedForMailingList | Bool |
Bestimmt, ob der Kontakt für Mailings (Newsletter) gesperrt ist. Mögliche Werte: |
| Tags | Array |
Die Merkmale des Kontaktes oder des Ansprechpartners Achtung: Die Merkmale werden nicht automatisch angelegt, wenn sie nicht existieren. |
| Communications.Type | Text | Der Typ des Kommunikationseintrags: PhoneOffice PhoneMobile PhoneHome PhoneOther FaxOffice EMailAddress EMailAddress2 Homepage Skype GooglePlus YouTube |
| VATIDNumber | Text | Umsatzsteuer ID Nummer |
| Address.AddressType | Text | Name eines vorhanden Anschriftstypen, z.B. "Büroanschrift" |