Letterbox Documentation

Docs: API keys and request tokens

  • Each form can have several API keys
  • Each API Keys can have many request tokens
  • Keys and tokens that decide if that form can be used
API keys has restrictions
  • Keys expire after a set time
  • Disabled keys never renew automatically. Generate a replacement key if needed.
Membership tiers and API keys
  • New keys start with a seven-day lifetime.
  • Your profile shows whether each key can renew automatically.
  • Eligible keys renew for one month when the hosted form is opened or submitted; you do not need to log in.
  • Older expired keys may need replacing. Use Generate API key in your profile; the hosted form link stays the same.
Generate API key
  • On the profile page, under a contact form, click the generate API key button.
  • A new API key is created and the full key is shown.
  • Hosted forms look up the API key directly, so you do not need to write it down.
  • Under the contact form the key is listed with the expiry date.
Request tokens
  • For hosted forms the tokens are generated automatically.
  • You do not need to generate tokens yourself.
  • In the profile, each API key also has a generate token button.
Further steps
  • Multiple API keys for the same form let a new key overlap with an older key you are replacing.