Mettre à jour un contact avec l'API Constant Contact
Met à jour un contact en remplaçant ses champs principaux : email_address, noms, job_title, company_name, birthday et anniversary omis deviennent vides, envoyez donc aussi les valeurs actuelles, obtenues via Lister les contacts. Les sous-ressources omises sont conservées, et celle qui est envoyée remplace l'actuelle.
- Identifiant
- constant_contact_update_contact
L'appel
POST https://connect.reportei.com/api/tools/constant_contact_update_contact/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"contact_id": "<contact_id>",
"update_source": "Account"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| contact_id | string | Oui | Id of the contact, from List contacts. |
| update_source | string | Oui | Who makes the change: Account when the account user changes it, Contact when the person asked for it. A deleted contact comes back only with Account.Valeurs : Account, Contact |
| email_address | object | Non | Email address of the contact. permission_to_send explicit or implicit is allowed only when the person agreed to receive emails; unsubscribed opts the contact out, with an optional opt_out_reason. |
| first_name | string | Non | First name of the contact. |
| last_name | string | Non | Last name of the contact. |
| job_title | string | Non | Job title of the contact. |
| company_name | string | Non | Company where the contact works. |
| birthday_month | integer | Non | Month of the birthday, 1 to 12. Send it together with birthday_day. |
| birthday_day | integer | Non | Day of the birthday, 1 to 31. Send it together with birthday_month. |
| anniversary | string | Non | Anniversary date, such as when the contact became a customer, as YYYY-MM-DD or MM/DD/YYYY. |
| phone_numbers | array | Non | Up to 3 phone numbers. When sent, they replace the current ones. |
| street_addresses | array | Non | Up to 3 street addresses, each with its kind. When sent, they replace the current ones. |
| list_memberships | array | Non | Ids of all the lists the contact should be in, from List contact lists, up to 50. When sent, the contact leaves the lists that are not in it. The current lists come from List contacts with include list_memberships. |
Connexions possibles
Votre client connecte son compte Constant Contact une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/constant_contact, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/constant_contact_update_contact. Il devient la définition de tool de votre agent sans conversion.
Autres tools Constant Contact
- Lister les contactsGETListe les contacts du compte, sans les supprimés par défaut, avec filtre facultatif par e-mail, liste, statut ou date. La réponse contient contacts et, quand il y en a plus, _links.next.href avec le curseur de la page suivante.
- Créer un contactPOSTCrée un contact et le renvoie avec son contact_id. Envoyez create_source et au moins email_address, first_name ou last_name. Une adresse e-mail déjà présente dans le compte répond 409.
- Lister les listes de contactsGETListe les listes de contacts avec list_id, name et description. Un compte compte jusqu'à 1000 listes, et une page en renvoie jusqu'à 1000.
- Créer une liste de contactsPOSTCrée une liste de contacts vide et la renvoie avec son list_id. Un nom déjà utilisé par une autre liste répond 409.
- Lister les campagnes e-mailGETListe les campagnes e-mail, de la plus récemment mise à jour à la plus ancienne, avec campaign_id, name, type et current_status, y compris les supprimées (Removed). Jusqu'à 500 par page ; atteignez les plus anciennes avec before_date et after_date. Les ids des activités viennent d'Obtenir une campagne e-mail.
- Obtenir une campagne e-mailGETRenvoie une campagne e-mail avec name, current_status et campaign_activities. Le campaign_activity_id avec role primary_email est celui que prennent les outils d'activité.
- Créer une campagne e-mailPOSTCrée une campagne e-mail en brouillon avec du contenu HTML personnalisé et la renvoie avec campaign_activities, où se trouve l'activité primary_email. Pour l'envoyer, définissez les listes avec Mettre à jour l'activité de la campagne e-mail puis utilisez Planifier l'activité de la campagne e-mail.
- Obtenir l'activité d'une campagne e-mailGETRenvoie une activité de campagne e-mail : expéditeur, objet, preheader, contact_list_ids ou segment_ids, format_type et current_status. html_content et physical_address_in_footer ne reviennent que s'ils sont demandés dans include.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
