Skip to main content

HubSpot event types

Learn about different types of HubSpot events.

Info

All HubSpot workflows require a HubSpot connection with enabled Shared credentials option.

Company created​

Triggers when a new company is created.

Company property changed​

Triggers when a property of a company is updated.

Company deleted​

Triggers when a company is deleted.

Contact created​

Triggers when a new contact is created.

Contact property changed​

Triggers when a property of a contact is updated.

Contact deleted​

Triggers when a contact is deleted.

Deal created​

Triggers when a new deal is created.

Deal property changed​

Triggers when a property of a deal is updated.

Deal deleted​

Triggers when a deal is deleted.

Example payloads​

Payload for company events​

{
  "event": {
    "attemptNumber": 0,
    "owner": {
      "id": "468810689",
      "email": "joe.doe@example.com",
      "firstName": "Joe",
      "lastName": "Doe",
      "userId": 46916146,
      "createdAt": "2022-09-13T12:53:46.897Z",
      "updatedAt": "2022-09-13T12:54:01.369Z",
      "archived": false
    },
    "eventId": 3418880613,
    "changeSource": "CRM_UI",
    "occurredAt": 1663842379678,
    "subscriptionType": "company.propertyChange",
    "propertyName": "hubspot_owner_id",
    "portalId": 27356661,
    "appId": 1109808,
    "propertyValue": "468810689",
    "company": {
      "id": "6355821024",
      "properties": {
        "creationDate": "2022-09-14T13:54:54.904Z",
        "lastModifiedDate": "2022-09-22T10:26:19.678Z",
        "objectId": "6355821024",
        "name": "example.com"
      },
      "createdAt": "2022-09-14T13:54:54.904Z",
      "updatedAt": "2022-09-22T10:26:19.678Z",
      "archived": false
    },
    "subscriptionId": 1859972,
    "objectId": 6355821024
  }
}
  • subscriptionType: The type of event. Can be company.creation, company.propertyChange or company.privacyDeletion
  • objectId: The ID of the company that was created/changed/deleted.
  • propertyName: The name of the property that was changed. Only sent for property change events.
  • propertyValue: The new value of the changed property. Only sent for property change events.
  • changeSource: The source of this change. Can be any of the change sources that you find on deal property histories.
  • company: The object indicates the company that this event occured for.
  • owner: The object that indicates the HubSpot owner of the company.
  • occurredAt: The timestamp of when this event occurred, as a millisecond.
  • eventId: The unique ID of the triggered event.
  • subscriptionId: The ID of the subscription that sent the event.
  • portalId: The HubSpot portalId that this event came from.
  • appId: The ID of Actioner application in HubSpot.
  • attemptNumber: Which attempt this event is sent for (starting at 0). If times-out or throws an error, Actioner attempts to retrive the event data again.

Payload for contact events​

{
  "event": {
    "attemptNumber": 0,
    "owner": {
      "id": "468810689",
      "email": "joe.doe@example.com",
      "firstName": "Joe",
      "lastName": "Doe",
      "userId": 46916146,
      "createdAt": "2022-09-13T12:53:46.897Z",
      "updatedAt": "2022-09-13T12:54:01.369Z",
      "archived": false
    },
    "eventId": 377048979,
    "changeSource": "CRM_UI",
    "occurredAt": 1663842903223,
    "subscriptionType": "contact.creation",
    "portalId": 27356661,
    "appId": 1109808,
    "contact": {
      "id": "201",
      "properties": {
        "creationDate": "2022-09-22T10:35:03.223Z",
        "email": "jane@example.com",
        "firstName": "Jane",
        "emailDomain": "example.com",
        "objectId": "201",
        "ownerId": "468810689",
        "lastModifiedDate": "2022-09-22T10:35:04.348Z",
        "lastName": "Doe",
        "lifecycleStage": "lead"
      },
      "createdAt": "2022-09-22T10:35:03.223Z",
      "updatedAt": "2022-09-22T10:35:04.348Z",
      "archived": false
    },
    "subscriptionId": 1749892,
    "objectId": 201
  }
}

  • subscriptionType: The type of event. Can be contact.creation, contact.propertyChange or contact.privacyDeletion
  • objectId: The ID of the contact that was created/changed/deleted.
  • propertyName: The name of the property that was changed. Only sent for property change events.
  • propertyValue: The new value of the changed property. Only sent for property change events.
  • changeSource: The source of this change. Can be any of the change sources that you find on deal property histories.
  • contact: The object indicates the contact that this event occured for.
  • owner: The object that indicates the HubSpot owner of the contact.
  • occurredAt: The timestamp of when this event occurred, as a millisecond.
  • eventId: The unique ID of the triggered event.
  • subscriptionId: The ID of the subscription that sent the event.
  • portalId: The HubSpot portalId that this event came from.
  • appId: The ID of Actioner application in HubSpot.
  • attemptNumber: Which attempt this event is sent for (starting at 0). If times-out or throws an error, Actioner attempts to retrive the event data again.

Payload for deal events​

{
  "event": {
    "attemptNumber": 0,
    "owner": {
      "id": "468810689",
      "email": "joe.doe@example.com",
      "firstName": "Joe",
      "lastName": "Doe",
      "userId": 46916146,
      "createdAt": "2022-09-13T12:53:46.897Z",
      "updatedAt": "2022-09-13T12:54:01.369Z",
      "archived": false
    },
    "eventId": 2925599207,
    "occurredAt": 1663842989358,
    "deal": {
      "id": "5529464002",
      "properties": {
        "amount": "52300",
         "closeDate": "2022-09-30T10:36:06.984Z",
         "creationDate": "2022-09-22T10:36:22.886Z",
         "dealName": "Example",
         "dealStage": "appointmentscheduled",
         "lastModifiedDate": "2022-09-22T10:36:29.689Z",
         "objectId": "5529464002",
         "ownerId": "468810689",
         "pipelineId": "default",
         "hs_next_step": "this is next step",
         "closed_lost_reason": "this is closed lost reason",
         "closed_won_reason": "this is closed won reason"
      },
      "createdAt": "2022-09-22T10:36:22.886Z",
      "updatedAt": "2022-09-22T10:36:29.689Z",
      "archived": false
    },
    "propertyValue": "0",
    "changeSource": "CALCULATED",
    "subscriptionType": "deal.propertyChange",
    "propertyName": "num_associated_contacts",
    "portalId": 27356661,
    "appId": 1109808,
    "subscriptionId": 1749909,
    "objectId": 5529464002,
    "currentPipeline": {
      "label": "Sales Pipeline",
      "displayOrder": 0,
      "id": "default",
      "stages": [
        {
          "label": "Appointment Scheduled",
          "displayOrder": 0,
          "metadata": {
            "isClosed": "false",
            "probability": "0.2"
          },
          "id": "appointmentscheduled",
          "createdAt": "1970-01-01T00:00:00Z",
          "updatedAt": "1970-01-01T00:00:00Z",
          "archived": false,
          "writePermissions": "CRM_PERMISSIONS_ENFORCEMENT"
        }
      ],
      "createdAt": "1970-01-01T00:00:00Z",
      "updatedAt": "1970-01-01T00:00:00Z",
      "archived": false
    }
  }
}
  • subscriptionType: The type of event. Can be deal.creation, deal.propertyChange or deal.privacyDeletion
  • objectId: The ID of the deal that was created/changed/deleted.
  • propertyName: The name of the property that was changed. Only sent for property change events.
  • propertyValue: The new value of the changed property. Only sent for property change events.
  • changeSource: The source of this change. Can be any of the change sources that you find on deal property histories.
  • deal: The object indicates the deal that this event occured for.
  • owner: The object that indicates the HubSpot owner of the deal.
  • currentPipeline: The object that indicates the current pipeline of the deal.
  • occurredAt: The timestamp of when this event occurred, as a millisecond.
  • eventId: The unique ID of the triggered event.
  • subscriptionId: The ID of the subscription that sent the event.
  • portalId: The HubSpot portalId that this event came from.
  • appId: The ID of Actioner application in HubSpot.
  • attemptNumber: Which attempt this event is sent for (starting at 0). If times-out or throws an error, Actioner attempts to retrive the event data again.