Documentación
superleads.mx

AssociationCreate

Eventos de Webhook · ☕ 2 min de lectura
Actualizado el 19 Jun 2026

Asociacion creada

Resumen

Se dispara cuando se crea una asociacion entre dos tipos de objetos (por ejemplo, contacto y empresa).

Este evento de webhook te avisa en tiempo real, sin que tu equipo tenga que estar revisando la plataforma manualmente. Configuralo una vez y deja que tu sistema reaccione automáticamente.

For example, in a real estate system, a company may want to associate potential buyers with specific properties. In this case: - The first object (buyer) would be a custom object representing the interested person. - The second object (property) would be a custom object representing the real estate listing. - The association label might be "Interested Buyer," indicating that the buyer has shown interest in the property. - The system could store multiple buyers per property (many-to-many relationship), allowing for flexible tracking of interest.

Schema

The webhook response follows the JSON schema below:

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "associationType": {
      "type": "string"
    },
    "firstObjectKey": {
      "type": "string"
    },
    "firstObjectLabel": {
      "type": "string"
    },
    "secondObjectKey": {
      "type": "string"
    },
    "secondObjectLabel": {
      "type": "string"
    },
    "key": {
      "type": "string"
    },
    "locationId": {
      "type": "string"
    }
  }
}

Field Descriptions

id

  • Type: string
  • Unique identifier for the association.

associationType

  • Type: string
  • Specifies the type of association (e.g., USER_DEFINED or SYSTEM_DEFINED).

firstObjectKey

  • Type: string
  • Key representing the first object in the association.

firstObjectLabel

  • Type: string
  • Readable label for the first object.

secondObjectKey

  • Type: string
  • Key representing the second object in the association.

secondObjectLabel

  • Type: string
  • Readable label for the second object.

key

  • Type: string
  • Unique key assigned to the association.

locationId

  • Type: string
  • Identifies the location associated with the created association.

Example Response

{
  "id": "67ade73d1119d2ac7ad0c475",
  "associationType": "USER_DEFINED",
  "firstObjectKey": "custom_objects.real_estate_buyer",
  "firstObjectLabel": "Interested Buyer",
  "secondObjectKey": "custom_objects.property",
  "secondObjectLabel": "Property",
  "key": "buyer_property_interest",
  "locationId": "eHy2cOSZxMQzQ6Yyvl8P"
}

Additional Notes

  • Ensure that your webhook listener is capable of processing POST requests.
  • The firstObjectKey and secondObjectKey help define relationships between entities.
  • The traceId is useful for debugging and logging purposes.