API Credentials for Holdout

Guide to obtaining tokens, keys, and connections.

The fastest way: log in at https://holdout.deals, open your account (your email, top right) and press "Connect to Botize". Sign in to Botize if it asks and press Authorize: the connection is created for you, with no key to copy. If you prefer to do it by hand, follow the steps below. To connect Holdout to Botize you need your Holdout API Key. It is one key for your whole account: you connect Holdout once, and in each Shorten URL step you choose which of your channels the link belongs to. A channel is each place where you post your deals: a Telegram channel, a WhatsApp group, a website… Holdout is free for Botize users. To see how to use it inside Botize step by step, with screenshots, check the guide at https://holdout.deals/botize.

Holdout API Key

  1. 1

    Go to https://holdout.deals and click "Create an account" (or "Log in", top right, if you already have one). There is no password: type your email in "Your email" and click "Send me a code".

  2. 2

    Check your email: you will get a six-digit code that expires in ten minutes. Type it in "The code" and click "Log in".

  3. 3

    On the "Your channels" page, create one channel for each place where you post: type its name in "Channel name" (for example, "Telegram gadgets") and click "New channel".

  4. 4

    Open your account: click your email at the top right. The "API key" section has your key. Click "View API key" and then "Copy": it starts with hdk_.

  5. 5

    In Botize, when you connect the Holdout app, paste the key in the "API Key" field. The connection takes your account's email as its name, and it works for all your channels.

  6. 6

    In each Shorten URL step, choose the channel in the "Channel" field. The list shows the channels of your Holdout account; if you create one later, it shows up there too.

  7. 7

    If you need the key again, it is always in your account (your email, top right), in the "API key" section. "Regenerate" gives you a new one, but the old one stops working immediately and you will have to connect Holdout again in Botize. Or simply press "Connect again" in the Botize section of your Holdout account.

  8. 8

    Each channel's click stats and suggestions are on its holdout.deals page. Suggestions ("Try a product") turn on once the channel has 8 deals with a title and 20 clicks, so fill in the title and price when you shorten links in Botize.