Bulletin: OneLink short URL TTLs automatically extend

For:
Developers Marketers
Last update:

What's new

The default time to live (TTL) for OneLink short URLs created via bulk upload, SDK (user invite), and OneLink API is extended each time the link is clicked:

  • Bulk upload: 180 days
  • SDK user invite: 60 days
  • OneLink API: 31 days
Effective date May 2, 2022
Where
  • OneLink bulk upload
  • User invite links (OneLink URLs created via SDK)
  • OneLink API
What's changing

Before the change: OneLink short URLs created via bulk upload, SDK (user invite), and OneLink API had a time to live (TTL). After the TTL expired, the links no longer worked as intended, and did not provide attribution data.

After the change: OneLink short URLs created via bulk upload, SDK (user invite), and OneLink API still have a TTL. However, each time the link is clicked, the TTL is extended:

  • Bulk upload: 180 days
  • SDK user invite: 60 days
  • OneLink API: 31 days
What you must know
  • The change affects new and pre-existing OneLink short URLs with TTLs.
  • For OneLink API:
    • You can change the default TTL by adding the parameter ttl={value} and specifying how many days, hours, or minutes. For example ttl=7d, ttl=12h, or ttl=10m.
  • For OneLink API and bulk upload:
    • If you don't want link TTLs to automatically extend, add the parameter renew_ttl=false to your links.
      Note:
      • The parameter renew_ttl doesn't display on the actual URL.
      • For OneLink API, the value is boolean; either true (default) or false.