# Crear consumo por email (https://docs.loybox.com.ar/api-reference/consumos/crear-por-email)



<Endpoint method="POST" path="/v1/consumptions/email" auth="api-key" />

Registra un nuevo consumo usando el email del cliente. Es el que conviene en un
checkout online, donde el email ya lo tenés y pedirle un código al cliente
sobraría.

<Callout title="Funciona aunque el cliente no tenga cuenta">
  Si el email no corresponde a ninguna cuenta de Loybox, el consumo **se crea
  igual** y automáticamente le llega un mail invitándolo a registrarse. Cuando se
  registra, los puntos de esa compra ya están esperándolo.

  Es la forma de que el programa empiece a acumular valor antes de que el cliente
  se sume.
</Callout>

## Cuerpo [#cuerpo]

<Fields>
  <Field name="client_email" type="string" required="true">
    Email del cliente que hizo la compra.
  </Field>

  <Field name="amount" type="integer" required="true">
    Monto de la compra, en unidades enteras de la moneda del comercio.
  </Field>
</Fields>

## Ejemplo [#ejemplo]

```bash
curl -X POST https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/consumptions/email \
  -H "Authorization: Bearer $LOYBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_email": "ana@example.com",
    "amount": 1750
  }'
```

```json
// 201 Created
{
  "message": "Consumption created successfully"
}
```

## Errores [#errores]

| Código | Cuándo                                                                                                                                    |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | No se pudo crear el consumo.                                                                                                              |
| `403`  | El cliente existe pero no es elegible para tener consumos.                                                                                |
| `404`  | El cliente no existe.                                                                                                                     |
| `422`  | Falta un campo del cuerpo, o el email no tiene formato válido. Ver [Errores de validación](https://docs.loybox.com.ar/api-reference/errores#errores-de-validación). |