BitelioBitelio
Referencia de APIContacts

Crear o actualizar contacto

Crea un contacto nuevo o actualiza uno existente (upsert por correo)


Versionado de rutas. Este recurso también responde en /contacts, sin versionar, que es donde siempre ha estado y donde seguirá funcionando indefinidamente — bitelio@0.1.0 llama ahí. Usa /v1/contacts: el prefijo /v1 es el que lleva una promesa de versión detrás, y un futuro /v2 podrá cambiar de forma sin romper nada escrito contra este.

POST
/v1/contacts

Authorization

ApiKeyAuth

AuthorizationBearer <token>

Autenticación mediante clave de API. Las claves secretas (sk_*) son obligatorias en todos los endpoints excepto /v1/track. Las claves públicas (pk_*) solo funcionan con el endpoint /v1/track para el seguimiento de eventos desde el cliente. El proyecto se deriva automáticamente de la clave.

In: header

Request Body

application/json

email*string
Formatemail
subscribed?boolean
Defaulttrue
data?

Response Body

application/json

application/json

curl -X POST "https://api.bitelio.com/v1/contacts" \  -H "Content-Type: application/json" \  -d '{    "email": "user@example.com",    "subscribed": true,    "data": {      "firstName": "John",      "lastName": "Doe",      "plan": "premium"    }  }'
{
  "id": "string",
  "email": "user@example.com",
  "subscribed": true,
  "data": {},
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "_meta": {
    "isNew": true,
    "isUpdate": true
  }
}
{
  "id": "string",
  "email": "user@example.com",
  "subscribed": true,
  "data": {},
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "_meta": {
    "isNew": true,
    "isUpdate": true
  }
}