Synupv1
Schlüssel erstellen
v1Ressourcen/Review Invites/postEmpfänger aktualisieren

Empfänger aktualisieren

Korrigiert Name, E-Mail-Adresse, Telefonnummer oder Kontakttyp eines Empfängers. E-Mail-Adresse und Telefonnummer werden eingefroren, sobald eine Nachricht an diesen Empfänger gesendet wurde — eine Änderung nach einem Versand liefert einen 409, da Zustellbestätigungen und Antworten an die tatsächlich verwendete Adresse gebunden sind.

post/api/v1/review-invites/update
review-invite:write
Anfragetext
recipientIdstringerforderlich
Der zu aktualisierende Empfänger. Erforderlich.
namestringoptional
Neuer Name.
emailstringoptional
Neue E-Mail-Adresse. Wird mit einem 409 abgelehnt, wenn diesem Empfänger bereits eine Nachricht gesendet wurde.
phonestringoptional
Neue Telefonnummer. Wird mit einem 409 abgelehnt, wenn diesem Empfänger bereits eine Nachricht gesendet wurde.
contactTypestring (Customer | Lead | Prospect | Contact)optional
Neuer Kontakttyp: Customer, Lead, Prospect oder Contact.
Antwort
dataobjectoptional
idstringoptional
Eindeutige Kennung des Empfängers.
namestringoptional
Der Name des Empfängers, oder leer, falls nicht angegeben.
emailstringoptional
Die E-Mail-Adresse des Empfängers, oder leer, falls nicht angegeben.
phonestringoptional
Die Telefonnummer des Empfängers, oder leer, falls nicht angegeben.
contactTypestringoptional
Einer von: Customer, Lead, Prospect, Contact.
statusstringoptional
Aktueller Zustellstatus für diesen Empfänger.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
409Die Anfrage steht im Widerspruch zum aktuellen Zustand der Ressource — zum Beispiel beim Ändern der E-Mail-Adresse oder Telefonnummer eines Empfängers, dem bereits eine Nachricht gesendet wurde, oder bei einer Team-Einladung, die bereits akzeptiert wurde (oder noch nicht akzeptiert wurde).
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/review-invites/update
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "id": "cm_recip_1",
    "name": "Jordan Lee",
    "email": "jordan@example.com",
    "phone": null,
    "contactType": "Customer",
    "status": "pending"
  }
}