Events are our way of letting you know when something interesting happens in your projects. When an interesting event occurs, we create a new Event object. For example, when a contact is created in a crm, we create a crm.contact.created event, and when a contact is updated, we create an crm.contact.updated event. Certain API requests might create multiple events. For example, after we pull data from a CRM plaftorm you may receive both a crm.contact.pulled event and some crm.contact.created events.

Events occur when the state of another API resource changes. The event’s data field embeds the resource’s state at the time of the change. For example, a crm.contact.updated event contains a CRM Contact, as the state of the contact is after the update.

When creating webhook endpoints to retrieve events from Panora, you have the flexibilty to only retrieve some events, for each endpoint. We also have a separate webhooks system for sending the Event objects directly to an endpoint on your server. You can manage webhooks in your account settings. Learn how to listen for events so that your integration can automatically trigger reactions.

​
The event Object

The event object is used to represent an existing change to an object. The typical implementation consists in listening for events and triggering worklows in your backend based on the content of the field type and data of the webhook.

​
Properties

​
event
Event Object
​
id_event
uuid

Panora Defined UUID for this event

​
type
string

The type of this event. Find list of existing events in the dedicated below.

​
data
json

Expect a unified object in this field. A crm.contact.created event would for example contain a CRM Contact object.

​
Securing your webhooks

We use secrets to make sure your endpoints do not receive data from third-parties usurpating Panora.

​
List of Event Types

This is a list of all the types of events we currently send. We may add more at any time, so in developing and maintaining your code, you should not assume that only these types exist.

You’ll notice that these events follow a pattern: resource.event. Our goal is to design a consistent system that makes things easier to anticipate and code against.

​
Event Types List
​
crm.contact.created

Occurs whenever a new contact was created in a CRM. The data field is a CRM Contact

​
crm.contact.updated

Occurs whenever a new contact was updated in a CRM. The data field is a CRM Contact

​
crm.contact.deleted

Occurs whenever a new contact was deleted in a CRM. The data field is a CRM Contact

​
connection.created

Occurs when a new connection was created. The data field is a Connection object.

JavaOverview