Ir al contenido
View in Postman (opens in new tab)

Fusionar usuarios

post

/users/merge

Utiliza este endpoint para fusionar un usuario con otro.

Puedes especificar hasta 50 fusiones por solicitud. Este endpoint es asíncrono.

Solución de problemas

Se devolvió una respuesta correcta, pero el usuario fusionado todavía aparece en las búsquedas

Una respuesta correcta confirma que se aceptó la solicitud, pero la operación de fusión consta de dos pasos: fusionar los perfiles y luego eliminar el perfil de origen. Por eso, el perfil identifier_to_merge puede seguir apareciendo en las búsquedas del panel durante un breve periodo después de una respuesta correcta. Es el comportamiento esperado: espera unos minutos y luego comprueba que la fusión se haya completado.

Si el usuario fusionado sigue existiendo después de varios minutos, comprueba que los identificadores de tu solicitud sean correctos y pertenezcan a usuarios del mismo espacio de trabajo que la clave de API utilizada en la solicitud.

Referencia de errores

En la siguiente tabla se enumeran los posibles mensajes de error que pueden producirse.

Error Solución de problemas
'merge_updates' must be an array of objects Comprueba que merge_updates sea una matriz de objetos.
a single request may not contain more than 50 merge updates Solo puedes especificar hasta 50 actualizaciones de fusión en una sola solicitud.
identifiers must be objects with an 'external_id' property that is a string, 'user_alias' property that is an object, 'email' property that is a string, or 'phone' property that is a string Comprueba los identificadores de tu solicitud.
'merge_updates' must only have 'identifier_to_merge' and 'identifier_to_keep' Comprueba que merge_updates solo contenga los dos objetos identifier_to_merge y identifier_to_keep.

Puedes descargar el documento OpenAPI y utilizarlo para validar esquemas. Para saber cómo hacerlo, consulta Utilizar esquemas OpenAPI para la validación de solicitudes.

New Stuff!