Letterbox

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
  • Keys can be disabled
Membership tiers and API keys
  • Free tier keys expire after 1 week
  • Paid membership tiers keys expire after 1 month
  • Free tier keys can not be renewed automatically
  • Paid membership tiers keys are automatically renewed
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.
  • You can write this down if you use the API or inline forms.
  • However if you use the hosted offering you do not need to.
  • Hosted forms look up the API key directly.
  • Under the contact form the key is listed with the expiry date.
Request tokens
  • For hosted forms the tokens are generated automatically.
  • However for API and inline forms you need to generate the tokens.
  • The API has request token generation endpoints.
  • And in the UI the by each API key, there is a generate token button.
Further steps
  • Multiple API keys for the same form may be useful for different applications, APIs etc.