Deprecation Announcement: API switching to Daily Account Metric Timestamps

On January 31, 2021, we will be deprecating the ability to send account metrics to Freshsuccess at a finer granularity than a daily timestamp. 

Currently, metrics can be sent to Freshsuccess via APIs with any timestamp. This data is then aggregated across the day when it is reported at our end. Post January 31, 2021, we will be removing that aggregating functionality and truncating metric timestamps to the day, keeping only the latest value for that day.  


This change means, post the date of deprecation, our customers who were previously sending a metric with multiple timestamps in a single day will now need to pre-aggregate the account metrics sent to Freshsuccess within a single given day. 

Note: On a given day, the latest entry for a specific metric will always overwrite the previous entry and will be considered as the aggregated value of the metric for that day.


Let’s take an example of a metric that needs to be aggregated on a daily basis, such as the daily number of logins.  

Metric  Value  Timestamp
# of logins 3 2020-12-12 08:00
# of logins 5 2020-12-12 10:00


Currently, these values are stored in the Freshsuccess database as two records. Freshsuccess then aggregates the values at the end of the day (in this case, 5 + 3 = 8 logins for December 12, 2020) and reports them in the dashboard.

Post January 31, 2021, customers can just send the aggregated value metric. That means the value sent across will need to be pre-aggregated and sent once daily. Any subsequent value for the metric sent with the same day timestamp will overwrite the previous one and be truncated to the start of the day.

For example, say, Freshsuccess receives the following values for the # of daily logins metric for the same day timestamp, 

Metric  Value  Timestamp
# of logins 3 2020-12-12 08:00
# of logins 8 2020-12-12 10:00


In this case, only the last record is stored in the Freshsuccess database, i.e.,  ('# of logins', 8, '2020-12-12 00:00')

We are here to help

Our goal is to make this deprecation smooth and uneventful, and we want to help minimize any costs. Please do not hesitate to reach out to us if you have questions, challenges, or concerns.