> ## Documentation Index
> Fetch the complete documentation index at: https://developers.avest.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# PATCH Contact

> Met à jour les champs d'identité et le consentement d'un contact existant. Chaque modification est tracée (activité d'audit).

Met à jour un **contact existant** de votre périmètre. Chaque champ modifié génère automatiquement une **activité d'audit** (`ATTRIBUTE_UPDATE`) visible sur la fiche.

## Endpoint

**URL** : `/external-integration/contact/{contactId}`
**Méthode** : `PATCH`
**Authentification** : Requiert un token LinkedAPI avec scope `externalIntegration`.
**Clé requise** : lecture-écriture. Une clé en lecture seule reçoit `403`. Voir [Types de clé](https://developers.avest.fr/guides/authentification.md).

> [!NOTE]
>
> L'autorisation `PATCH` doit être activée sur le scope `externalIntegration` de
> votre clé. Une clé en lecture seule reçoit `403 Not authorized to access this
>     resource` — la même réponse qu'un header `Authorization` absent. Contactez
> Avest si vous recevez un `403` alors que la lecture fonctionne.

## Headers

```
Content-Type: application/json
Authorization: Bearer {token}
```

## Path Parameters

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `contactId` | ObjectId | ✅ | ObjectId du contact à mettre à jour. |

## Body Parameters

Au moins **un** champ doit être fourni. Seuls les champs listés sont modifiables.

| Champ | Type | Description |
| - | - | - |
| `firstName` | String | Prénom. |
| `lastName` | String | Nom. |
| `title` | String | Civilité : `mr` (Monsieur) ou `mme` (Madame). Particuliers uniquement. |
| `commercialName` | String | Nom commercial (entreprise). |
| `corporateName` | String | Raison sociale (entreprise). |
| `siren` | String | SIREN. |
| `website` | String | Site web. |
| `address` | String | Adresse. |
| `consent` | Object | Consentement par canal. Voir [Consentement](https://developers.avest.fr/guides/consentement.md). |

> [!WARNING]
>
> **Les coordonnées (email / téléphone) ne sont pas modifiables via cette
> route.** Pour ajouter/corriger un email ou un téléphone, contactez Avest — une
> édition naïve risquerait de supprimer les autres coordonnées du contact.

## Consentement

Un `consent` seul suffit à constituer une requête valide. Chaque canal (`email`, `phone`, `sms`) est énoncé explicitement : `true` accorde, `false` retire, un canal absent n'est pas touché. Un `true` exige `date` ; `"phone": true` exige aussi la mention affichée (`wordingText`, `wordingVersion`, `locale`). Sans elles, toute la requête est refusée (`400`) et rien n'est modifié, pas même les champs d'identité qu'elle porte. Un retrait seul (`false`) n'exige ni date ni mention.

```json theme={null}
{
  "consent": {
    "email": true,
    "sms": false,
    "date": "2026-08-01T09:30:00.000Z",
    "details": "Confirmation téléphonique du 1er août"
  }
}
```

Ne transmettez `true` que pour un **nouvel accord** de la personne. Sur un canal encore consenti, un `true` n'est enregistré que si sa `date` est postérieure à celle du recueil déjà enregistré ; sinon il est ignoré et ne prolonge rien. Sur un canal retiré depuis, le même `true` **rétablit** le consentement : ne renvoyez pas un consentement déjà transmis, et n'envoyez `true` sur un canal retiré que pour un accord donné par la personne après son retrait. La mention reste exigée pour `"phone": true`, même quand l'accord est ignoré.

La réponse porte `consentChanged`. Un renvoi ignoré, comme le retrait d'un canal déjà retiré, n'écrit rien : si aucun autre canal ne change, `consentChanged` vaut `false`.

> [!NOTE]
>
> `consent.journey` n'est accepté qu'à la **création** — ici la requête est
> rejetée. Une mise à jour énonce chaque canal.

Détail des durées, bornes et de la traçabilité : [Consentement à la prospection](https://developers.avest.fr/guides/consentement.md).

## Audit

Chaque champ modifié crée une activité `ATTRIBUTE_UPDATE` sur la fiche (consultable via `GET /external-integration/activities?document={contactId}&documentType=contact`). L'activité n'est pas attribuée à un collaborateur (origine API externe).

## Exemple de requête

```json theme={null}
{
  "firstName": "Jean-Pierre",
  "lastName": "Dupont"
}
```

## Réponse de succès

**Code** : `200`

```json theme={null}
{
  "success": true,
  "contact": {
    "id": "618a35a36d932054e195ca0a",
    "firstName": "Jean-Pierre",
    "lastName": "Dupont",
    "contactDetails": [{ "type": "email", "data": "jean.dupont@email.com" }]
  }
}
```

## Réponses d'erreur

* **`contactId` invalide** : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "ExternalIntegrationUpdateContact : Invalid contactId"
}
```

* **Aucun champ modifiable fourni** : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "ExternalIntegrationUpdateContact : No editable field provided. Allowed: firstName, lastName, title, commercialName, corporateName, siren, website, address, consent"
}
```

* **Contact introuvable ou hors périmètre** : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "ExternalIntegrationUpdateContact : Unable to find contact"
}
```

* **Contact supprimé définitivement** : `409 Conflict`, quand le `consent` de la requête modifierait la fiche.

```json theme={null}
{
  "success": false,
  "errorCode": "CONTACT_DELETED",
  "message": "Contact is locked: deleted"
}
```

* **Header `Authorization` absent, clé en lecture seule, ou IP non whitelistée sur une clé sécurisée** : `403 Not authorized to access this resource`

```json theme={null}
{
  "success": false,
  "message": "Not authorized to access this resource"
}
```

* **Token invalide** : `401 Invalid bearer token`

```json theme={null}
{
  "success": false,
  "message": "Invalid bearer token"
}
```

## Rate limits

**100 req / minute par groupe d'agences** (un compteur par groupe d'agences × route : les autres routes d'écriture ont chacune le leur). Dépassement → `429 Too Many Requests`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.