---
title: "Ajouter ou compléter une fiche"
method: POST
path: "/contacts"
tags: ["Clients"]
---

# Ajouter ou compléter une fiche

`POST /contacts`

## Request

- Base URL: `https://fondatoria.com/api/v1`
- URL: `https://fondatoria.com/api/v1/contacts`
- Auth: HTTP bearer

La personne est retrouvée par son e-mail, sinon son téléphone. Les champs déjà remplis ne sont jamais écrasés ; les étiquettes s'ajoutent.

## Request body

- NewContact
  - `name` string
  - `email` string, email
  - `phone` string
  - `company` string
  - `tags` string[]

## Response `200`

Fiche complétée

- object
  - `data` Contact
    - `id` string
    - `name` string
    - `email` string, nullable
    - `phone` string, nullable
    - `company` string, nullable
    - `address` string, nullable
    - `tags` string[]
    - `createdAt` string, date-time
  - `created` boolean

## Other responses

- `201`: Fiche créée
- `400`: Requête invalide
- `401`: Clé absente, inconnue, révoquée ou expirée
- `403`: Autorisation manquante ou site inactif
- `429`: Quota dépassé ; voir Retry-After

---

[API](https://skmtc.dev/fondatoria/apis/api-sitebuilder.md) · [All operations](https://skmtc.dev/fondatoria/apis/api-sitebuilder/llms.txt) · [OpenAPI document](https://skmtc.dev/fondatoria/apis/api-sitebuilder/revisions/3e438376beac?raw)
