Adición compleja de leads con contacto y compañía

Limitaciones

El método está disponible de acuerdo con los permisos del usuario.
Para un lead, puedes especificar no más de un contacto relacionado y una compañía relacionada.
Para las entidades añadidas (lead, contacto, compañía), puedes transferir no más de 40 valores de campos adicionales.
Los datos que añadas participan en el control de duplicados si la opción está habilitada para la integración que añade los datos.
El método no realiza control de duplicados entre los leads ya añadidos.
El método no realiza control de duplicados para los leads en la misma solicitud.
El método busca duplicados entre los leads añadidos actualmente y los que ya han sido añadidos.
Puedes añadir no más de 50 leads por solicitud.
Cuando crees un nuevo contacto y una compañía, se vincularán entre sí.

Encabezado de tipo de datos cuando la solicitud es exitosa
Content-Type: application/hal+json.

Encabezado de tipo de datos en caso de un error
Content-Type: application/problem+json.

Ejemplo de respuesta

La primera vez que ingreses el lead, se añadirá normalmente.

[  
   {  
       "id": 9774766,  
       "contact_id": 12117258,  
       "company_id": 12117260,  
       "request_id": [  
           "1"  
       ],  
       "merged": false  
   }  
]

Ahora, vamos a hacer algunos cambios en el cuerpo de la solicitud. Por ejemplo, cambiemos el nombre y el ID de la solicitud y enviémosla nuevamente. De acuerdo con las reglas de control de duplicados en nuestra cuenta y en el pipeline donde realizamos la solicitud, el lead se considera un duplicado. Se recibe la respuesta con el valor true de la bandera merged.

[  
   {  
       "id": 9774766,  
       "contact_id": 12117258,  
       "company_id": 12117260,  
       "request_id": [  
           "2"  
       ],  
       "merged": true  
   }  
]

Parámetros de respuesta

Parámetro	Descripción
id	ID del lead.
contact_id	ID de contacto.
company_id	ID de la compañía.
request_id	Un arreglo de IDs de solicitudes que han sido añadidas. Si no se encontraron duplicados, el arreglo siempre tendrá un solo elemento. Si se pasan múltiples duplicados del mismo lead, el arreglo de request_id contendrá los identificadores de los leads pasados que son duplicados.
merged	Una bandera indica si se encontró un duplicado según las condiciones de búsqueda de duplicados y si se realizó la fusión.

Obtén más información sobre metadata y custom_fields_values, utilizados en los parámetros del cuerpo.