Mailing History
The campaign's History tab is going to be your greatest asset for tracking the status of individual mailers, testing integrations, and viewing incoming Request Details. Once a One Time Send has launched and processed or a trigger is set live and is sending requests, a list of individual mailers will start to appear.
If testing a trigger integration, the History tab is where you'll want to look to confirm the requests are successful, merge tags are populating correctly, and all the necessary mailing data is coming through as expected.
IN THIS ARTICLE
Mailing States & Environment
In the top right you'll see a tool for filtering by Mailing State and/or Environment, the option to Download a CSV record, and a calendar tool for filtering by date. In the top left you'll see a mailing count which reflects the filter settings.
| Status | Description |
| processing | Confirming all details of the mailing and production. |
| production | The mailer has passed data and suppression checks and is in print production. |
| holdout | Not mailed as part of the control group. |
| suppressed | The mailer recipient was found on your Do Not Mail list, or suppressed due to another setting such as regional, domain, or recently mailed. |
| delivered | Scanned and processed for delivery by USPS. |
| in_transit | The mailer has received one or more USPS mail scans and is on its way to the recipient. The Mailed state also falls under in-transit. |
| exception | An exception occurred while processing. This includes invalid addresses, unmatched emails for Address Enrichment, campaign budget exceeded, or insufficient account credit. |
| production_key | Successful trigger requests using your Production API Key. |
| test_key | Incoming trigger requests using your Test API Key. |
Numbers and mailing status are most accurately reflected under the History tab. While the graphs shown on the overview page are a useful visual aid, always refer to the campaign History for the most detailed account.
Once a mailer is In Transit or Mailed, status updates are based on incoming scans from USPS. If you notice a slight lag in delivery updates, we recommend checking back in later or the following day in case USPS hasn't updated their data yet.
In-home Timeline
Below is a typical average timeline for First Class and Standard mailers sent through Poplar; this is an important factor to consider when calculating the launch date of your campaign:
Poplar is optimized for speed, so mailers are sent to production almost immediately and begin printing within 24 hours. Depending on the postage used, in-home time can be as little as 3-7 days. Mailers sent in the early-to-late afternoon may not enter production until the following day.
Download CSV
The Mailing State, Environment and Calendar filter setting will be applied when downloading a CSV record. Shortly after clicking Download CSV, you'll receive an email from no-reply@heypoplar.com with a download link - this email can take up to 15 minutes to arrive depending on the amount of data requested.
Your CSV record will contain the following data columns:
| campaign_id | The ID of the parent campaign. |
| campaign_name | The name of the parent campaign. |
| mailing_id | The ID of the individual mailing. |
| current_state | The current state of the mailing. |
| mailing_time | The timestamp when the mailing was created. This is in UTC. |
| scheduled_for | The scheduled mailing time (if set). |
| postage_type | The type of postage applied to the mailing (usually either first class or standard mail). |
| format | The format of the mailing (e.g. "6x9 postcard") |
| creative_id | The ID of the creative used for the mailing. If you are running an A/B test of multiple creative then this will be different per creative. |
| creative_name | The name of the creative used for the mailing. |
| The email address submitted with the mailing. | |
| external_id | The external_id provided when creating the mailing. |
| name | The name printed on the mailing. |
| address_1 | Address line 1 When using the address append functionality, as per our terms of use, this information is redacted and not provided for download. |
| address_2 | Address line 2 When using the address append functionality, as per our terms of use, this information is redacted and not provided for download. |
| city | |
| state | |
| postal_code | 5 Digit postal code |
| postal_code_ext | 4 digit postal code extension |
| expected_delivery_date | The expected delivery date of the mailing. This is an estimate calculated based on submission time and historical mailing data. |
| actual_delivery_date | The date of the USPS delivery scan. Typically this occurs at the local post office, within 0-48 hours of the mailing arriving at the recipients mailbox. |
| estimated_cost | The estimated cost of the send based on the postage and format of the mailing. |
| send_type | The type of send. Valid values are API and MANUAL. This indicates if the mailing was triggered by our API or if it was created as a one-time send. |
| manual_send_id | This allows you to group mailings that are part of a one-time send. |
| merge_tags | The merge tags used for the mailing. |
| environment | This indicates if a test API key was used for the mailing. Valid values are test and production. |
| |
Mailing Data
If you're looking to download a record of mailing history across all campaigns, this can be done from the Mailing Data tab under API:
Individual Mailers
Each individual mailer, along with a unique mailing ID will appear listed under the History tab. Click into a mailer to see a summary of the Mailing Details, Event Log, and Request Details. If the mailer is or was in print production, you'll see an image preview with address and merge tag (if applicable) data applied and the option to download a PDF proof:
Mailing Details
Under the Mailing Details you see the Recipient Address, Campaign name, Creative name, Postage Type, Trigger Source (API Request or Manual Send), Creative Type, send_at trigger setting, Estimated Cost (price per piece), and a list of any custom merge tags used showing their name and value as populated based on mailing data.
Event Log
The Event Log shows a Timestamped record of how long the mailer spent in each step of the mail cycle from Created to Delivered.
Request Details
If the mailer was launched via trigger or integration with our Mailing API, the individual webhook data will be shown in the Request Details.
