Skip to main content

​
POST /v1/contacts

Crea un nuovo contatto nella rubrica del centralino.
Ogni account può registrare al massimo 4000 contatti. Quando il limite è raggiunto, la creazione di nuovi contatti viene rifiutata con un errore 403. La modifica dei contatti esistenti resta sempre consentita.

​
Request Body

CampoTipoObbligatorioDescrizione
numberstring✅Numero di telefono (max 25 caratteri)
namestring✅Nome del contatto (max 80 caratteri)
companystring❌Azienda (max 50 caratteri)
notesstring❌Note (max 255 caratteri)
Il campo number ammette cifre e i caratteri + ( ) . - / e spazi. La coppia account + numero deve essere univoca.

​
Richiesta

curl -X POST https://api.mycentralino.com/v1/contacts \
  -H "X-API-KEY: sk_mycentralino_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "3331234567",
    "name": "Mario Rossi",
    "company": "ACME S.r.l.",
    "notes": "Cliente principale"
  }'

​
Risposta Successo

201 Created 
{
  "success": true,
  "data": {
    "id": 12347,
    "number": "3331234567",
    "name": "Mario Rossi",
    "company": "ACME S.r.l.",
    "notes": "Cliente principale"
  }
}

​
Errori

​
400 - Dati non validi

{
  "success": false,
  "error": "Il campo \"number\" e' obbligatorio."
}

​
403 - Limite raggiunto

{
  "success": false,
  "error": "Limite massimo di 4000 contatti raggiunto. Impossibile aggiungere nuovi contatti.",
  "limit": {
    "max": 4000,
    "used": 4000
  }
}

​
409 - Numero già presente

{
  "success": false,
  "error": "Esiste gia' un contatto con questo numero in rubrica."
}

​
Note

  • Il limite di 4000 contatti è per account.
  • I campi company e notes sono opzionali: se omessi o vuoti vengono salvati come null.