Contatti

Crea e gestisci il database di contatti della tua organizzazione.

Elencare i contatti

GET /v1/contacts

Recupera una lista paginata di contatti.

Scope richiesto: contacts:read

Parametri di query

Parametro	Tipo	Descrizione
page	integer	Numero pagina (default: 1)
limit	integer	Risultati per pagina (default: 20, max: 100)
search	string	Cerca per nome, email, telefono o azienda

Esempio

curl "https://api.replicer.ai/v1/contacts?search=mario&limit=10" \
  -H "Authorization: Bearer rpl_live_your_key"

Risposta 200 OK

{
  "data": [
    {
      "id": "clx-contact-001",
      "firstName": "Mario",
      "lastName": "Rossi",
      "company": "Acme Corp",
      "jobTitle": "CTO",
      "phoneNumber": "+1234567890",
      "email": "[email protected]",
      "street": "Via Roma 123",
      "city": "Milano",
      "state": "MI",
      "postalCode": "20100",
      "country": "IT",
      "website": "https://acme.com",
      "birthday": "1990-03-15T00:00:00Z",
      "notes": "Incontrato alla conferenza",
      "createdAt": "2026-03-01T10:00:00Z",
      "updatedAt": "2026-04-01T15:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 45,
    "totalPages": 5
  },
  "requestId": "req-abc123"
}

---

Creare un contatto

POST /v1/contacts

Crea un nuovo contatto nella tua organizzazione.

Scope richiesto: contacts:write

Body della richiesta

Campo	Tipo	Obbligatorio	Descrizione
firstName	string	No*	Nome
lastName	string	No*	Cognome
company	string	No*	Azienda
jobTitle	string	No	Ruolo
phoneNumber	string	No*	Numero di telefono in formato E.164
email	string	No*	Indirizzo email
street	string	No	Via
city	string	No	Città
state	string	No	Provincia
postalCode	string	No	CAP
country	string	No	Codice paese (es. IT)
website	string	No	URL del sito web
birthday	string	No	Data ISO 8601
notes	string	No	Note libere

INFO

*Almeno uno tra firstName, lastName, company, phoneNumber o email è obbligatorio.

Esempio

curl -X POST https://api.replicer.ai/v1/contacts \
  -H "Authorization: Bearer rpl_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Laura",
    "lastName": "Bianchi",
    "phoneNumber": "+391555123456",
    "email": "[email protected]",
    "company": "Bianchi Srl"
  }'

Risposta 201 Created

{
  "data": {
    "id": "clx-contact-002",
    "firstName": "Laura",
    "lastName": "Bianchi",
    "company": "Bianchi Srl",
    "jobTitle": null,
    "phoneNumber": "+391555123456",
    "email": "[email protected]",
    "street": null,
    "city": null,
    "state": null,
    "postalCode": null,
    "country": null,
    "website": null,
    "birthday": null,
    "notes": null,
    "createdAt": "2026-04-05T10:00:00Z",
    "updatedAt": "2026-04-05T10:00:00Z"
  },
  "requestId": "req-def456"
}