Pre-chequeo de duplicados antes de import
POST
/v1/bulk/contacts/import-preview
const url = 'https://api.mailerdash.com/v1/bulk/contacts/import-preview';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"emails":["example"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.mailerdash.com/v1/bulk/contacts/import-preview \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "emails": [ "example" ] }'Recibe un array de emails y devuelve cuáles ya existen en la BD del key, sin tocar nada. Usado por el dashboard para mostrar “X contactos ya existen” antes de confirmar el import real.
Authorizations
Sección titulada «Authorizations »Request Body required
Sección titulada «Request Body required » Media type application/json
One of:
object
emails
required
Array<string>
Array<string>
Example generated
{ "emails": [ "example" ]}Responses
Sección titulada « Responses »Lista de emails ya existentes
Media type application/json
object
existing
Array<string>
total_unique
integer
total_received
integer
invalid_syntax
Estimado rápido de emails con sintaxis inválida (no verifica MX, así que es una cota inferior de lo que rechazará el import real).
integer
validation_min
Tamaño mínimo de import para que aplique el gate de % inválidos.
integer
max_invalid_pct
% máximo de inválidos tolerado en imports grandes; por encima, el import responde 422 too_many_invalid_recipients sin insertar nada.
integer
Example generated
{ "existing": [ "example" ], "total_unique": 1, "total_received": 1, "invalid_syntax": 1, "validation_min": 1, "max_invalid_pct": 1}Formato invalido
No autorizado