One-time link API

Use this API to generate a single use link which allows only one vox to be sent through an existing hosted page channel

  • Access to this API requires an API Key. Please contact us to obtain one
  • This API can be used with any active hosted page channels (but not plugin channels) within the account associated with the API key
  • The API will return a URL to the channel with a One Time Token that will expire after either a single vox has been sent through it, or in any case after 30 days
  • To use the API, POST to:
https://api.telbee.io/onetime?api_key=<API Key>&token=<Channel Token>
  • The Channel Token is the long string in a channel's full URL (where you are redirected after visiting a short URL, e.g. https://telb.ee/k6uthk1). This string may contain both alphanumeric characters and symbols.

    In this example it is highlighted in orange:
https://telbee.io/channel/z1hn2xmilpbl9pruppplqw/
  • The response body will be JSON in the following format, containing a 1-time use URL for the channel:
{"onetime":"https://telbee.io/channel/<Different Channel Token>/index.html?token=<One Time Token>"}
  • The API creates a duplicate of the original channel with a different channel token, so as not to expose the token of the original channel. For this reason, the first time this API is used with a particular channel, it will take approximately 1 minute for the link returned to be valid. If the link is accessed before then, it will be invalid and cached as invalid. After this initial delay, links returned by the API for that channel will be active immediately.
  • Any updates to the original channel will be reflected in the duplicate, including deactivation and reactivation
  • The duplicate channel requires a valid, unexpired One Time Token to load and send a vox. If the token is missing, invalid or expired, or if the channel has been deactivated, the user will be shown a page like https://telbee.io/channel/oops.html

We'll send you the ebook straight to your inbox!

Please leave us a few details below

Thank you! We'll be in touch very soon!
Oops! Something went wrong while submitting the form.