# Hand out personal promo codes from your website, with a deadline you choose

If your own website or marketing tool talks to BookingBible through the API, it can now hand one code from a promo-code batch to one person, give that code a deadline, and email it to them in your brand's style.

- **Only batches set up for it.** Personal codes come only from a promo-code batch that has been set up for personal codes (ask BookingBible support to set one up for you); your other campaigns are never touched.
- **One person, one code.** Asking again for the same email address returns the same code, however many times the request is repeated. When every code in the batch has been handed out, BookingBible says so instead of creating more, so the batch size is your budget.
- **The code is personal.** It only works for someone who signs in or creates their account with the email address it was issued to.
- **A deadline you choose, set once.** Your site decides how long the code lasts (from 1 minute to 24 hours) and when the clock starts, for example when the person opens your offer page. Setting it again never restarts or extends it. Every checkout already refuses a code past its deadline.
- **A branded email.** BookingBible can email the code to its owner with your brand's name, logo and colours, a link to your own page, and your own subject and message. You can also send just the button to your offer page, without the code itself. When the code was issued for one of your leads, it is only sent if that lead agreed to receive offer emails from you; if your site issues a code without naming a lead, your site is responsible for that consent. Each code can be emailed at most three times a day, and people who unsubscribed from your promotional email never receive it.
- **A code can also end early.** A code can expire by itself if it is never opened, and all personal codes stop when their promotion ends.
- **Leads can belong to a brand.** A lead captured from your website can now carry one of your brands, and the same email never creates duplicate leads, even when two forms are submitted at the same moment. Website-form leads that were previously refused are now saved.

- **Consent is saved with the lead.** When your form sends the consent it showed (for example "email me offers"), BookingBible stores it as evidence together with the lead, with the exact wording and policy version.
- **Your site can show your real registration fee.** Public pricing now includes each pass's registration fee for under-30 and over-30 buyers, the same amounts offers use, so your pages never need a hard-coded fee.
- **Your site can check a code.** It can look up a code it issued to see whether it is still usable and when it runs out.

Your integration also gets webhook events when a code is issued, gets its deadline, is emailed, is used, or expires, so your follow-up emails can react to what actually happened.

This needs an API key with the new **Issue personal promo codes** permission (`write:promo_codes`); looking a code up also works with the read-only `read:promo_codes` permission. Nothing changes for batches you already export or sell through partners: they cannot be handed out this way. Nothing changes in the Business, Consumer or branded apps, and your clients receive nothing unless your integration asks BookingBible to send the email.