Basic HubSpot Integration Event Status Codes

It’s easy to use Event Status Codes in HubSpot to accomplish a wide variety of integration tasks. They’re designed to help marketers, salespeople, and businesspeople to automate the process of consuming delivery and response campaign data and initiate automations from direct mail that have never previously been possible.

Event Status Codes In HubSpot Contacts

Postalytics automatically creates a Custom Property in HubSpot Contacts when either of two things happen:

  • You create a Smart Send Campaign using a Contact List that was imported using the HubSpot Integration

  • You create a Triggered Drip Campaign and sync the activity back to HubSpot

Each Postalytics Campaign (Smart Send or Triggered Drip) is assigned a unique Mail Drop Number that is created as a Custom Property in HubSpot Contacts.

Example: “Postalytics Mail Drop 110“. 

This is now the field that will track the delivery and response status for the length of the campaign. Once this field is created, you can modify the Name, or Label of the status code in HubSpot Property Settings.

How Do You Find The Postalytics Campaign Mail Drop ID? 

The Mail drop ID is the unique code that Postalytics assigns to each campaign. It is used in the Event Status Codes to uniquely identify your different campaigns. You can find the Mail drop ID at the top of your Campaign Dashboard.

Please note that if you’re using the “Add A Mail Drop” feature, each “Drop” will have a unique mail drop ID associated with it.

Common Event Status Code Use Cases 

Postalytics and HubSpot can be easily used together to automate many tasks that have traditionally been too hard, time consuming or expensive to attempt with traditional direct mail technology. Typically, these automation tasks involve HubSpot Workflows. Some typical things that marketers focus on include:

  1. Sending an email to a mail recipient based on the timing of the mail delivery

  2. Triggering the next step in a workflow

  3. Sending a text message to a sales rep when a mail recipient completes their online goal URL

It is easy to access the Event Status Codes from within HubSpot Workflows. They appear as a Custom Contact Property that Postalytics creates, and they always begin with “Postalytics”.

What Are The Postalytics Status Codes That Appear In HubSpot? 

MailPieceCreated – the mailpiece final PDF has been generated and sent to the print delivery network for fulfillment.

Addressed – some campaigns will create an event when the addressing of the mailpiece is completed.

Printed – some campaigns will create an event when the printing of the mailpiece is completed.

Mailed – the mailpiece has received the initial scan from the USPS (this is often 12-24 hours after the hand-off from the printer to the USPS).

InTransit – the mailpiece is being processed at the entry/origin facility.

InLocalArea – the mailpiece is being processed at the destination facility.

ProcessedForDelivery – the mailpiece has been greenlit for delivery at the recipient’s nearest postal facility. The mailpiece should reach the mailbox within 1 to 2 business days of this scan event. Our experience is that the majority of deliveries occur within 1 day of this scan.

**Note** Use this status code to trigger other actions based on mail delivery. For example, you can use the Processed For Delivery event, with a 2 day “Wait” in an automation sequence, to send automated messages out to coincide with mail delivery.

ReRouted – the mailpiece is re-routed due to recipient change of address, address errors, or USPS relabeling of barcode/ID tag area.

ReturnedToSender – The mailpiece is being returned to sender due to barcode, ID tag area, or address errors.

pURLOpened – the recipient has visited their pURL. Each visit will trigger a new event.

pURLCompleted – the recipient has visited their Goal URL. Each visit will trigger a new event.

Status Codes for Canadian Mailings

Because Canada Post does not provide tracking through the mail stream, mailings in Canada will have fewer Status Codes that will appear in HubSpot. For Canadian mailings, the Status Codes that you will see are:

MailPieceCreated – the mailpiece final PDF has been generated and sent to the print delivery network for fulfillment.

Addressed – the addressing of the mailpiece has been completed.

Printed – the printing of the mailpiece has been completed.

Mailed – the printer has handed off the mailpiece to Canada Post.

pURLOpened – the recipient has visited their pURL. Each visit will trigger a new event.

pURLCompleted – the recipient has visited their Goal URL. Each visit will trigger a new event.