Saltar al contenido principal
POST
curl

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json
counterparty
string<uuid>
requerido

El id de la entrada del directorio.

email
string<email>
requerido
Maximum string length: 254
name
string

Etiqueta opcional.

Maximum string length: 255

Respuesta

Se añadió el contacto.

Una dirección de cumplimiento a la que escribe el canal EMAIL para una entrada del directorio.

uuid
string<uuid>
counterparty
string<uuid>

El id de la entrada del directorio, tal como lo muestra GET /v3/travel-rule/vasps/.

counterparty_name
string
email
string<email>
name
string

Etiqueta opcional, por ejemplo el nombre del equipo.

source
enum<string>

staff: seleccionada por Didit. learned: una dirección en uno de los dominios propios del VASP que respondió a una solicitud mediante su enlace de respuesta. application: añadida por tu aplicación.

Opciones disponibles:
staff,
application,
learned
scope
enum<string>

platform: seleccionado por Didit o aprendido de una respuesta verificada, se usa para todos los clientes de Didit y es de solo lectura para ti. application: privado de tu aplicación.

Opciones disponibles:
platform,
application
created_by
string

Vacío para los contactos de la plataforma y para los contactos que añadió una clave de API.

verified_at
string<date-time> | null

Cuándo respondió esta dirección por última vez a una solicitud mediante su enlace de respuesta.

is_invalid
boolean

true una vez que la dirección rebotó o registró una queja; el canal EMAIL la omite.

invalid_reason
enum<string>
Opciones disponibles:
,
hard_bounce,
soft_bounce,
spam_complaint,
suppressed
invalid_detail
string

El motivo del servidor de correo receptor, cuando indicó uno.

invalid_at
string<date-time> | null
created_at
string<date-time>
Última modificación el 1 de noviembre de 2026