Tildei API Keys allow external systems to interact with your Tildei organization programmatically — for example, to trigger agent conversations, manage contacts, or integrate Tildei into your own workflows and automations.

Creating an API Key

1. Navigate to Settings in the sidebar
2. Go to API Keys
3. Click Create API Key
4. Give the key a descriptive name (e.g., Klaviyo Integration or Booking Webhook)
5. Set an expiration — keys can be created with up to a 1-year validity
6. Assign the permissions the key needs, scoped to the minimum required for your use case
7. Click Create and copy the key value immediately — it won't be shown again

All Tildei API key values begin with tildei_.

Using an API Key

Include your API key as a Bearer token in the Authorization header of any Tildei API request:

Authorization: Bearer tildei_your_key_here

For full API documentation and available endpoints, contact your Tildei team.

Managing Keys

• Rotate keys regularly, especially for high-permission integrations
• Revoke immediately if a key may have been exposed or is no longer in use