Integrations connect your application to external services — such as Aha!, Salesforce, Slack, HubSpot, and Zendesk — so your app can read from and write to those systems. Each integration stores the credentials your application needs to authenticate with the service (e.g., an API key or personal access token). Aha! Builder encrypts these credentials at the application layer so they are not exposed in your application code or server logs.
To open the Integrations page, click Configuration in your application's navigation bar and select the Integrations tab.
Click any of the following links to skip ahead:
Add an integration
The simplest way to add an integration is to describe it to Elle, the AI assistant. Click the Elle icon in your application and write what you want to integrate with in the prompt box. Elle will write the integration code for you, ask for the necessary credentials, and save them to the Integrations page automatically.
You can also add an integration manually on the Integrations page:
Built-in services: Click the card for a supported service — such as Aha!, Salesforce, Slack, HubSpot, or Zendesk. The modal pre-fills a suggested name and links out to step-by-step instructions for that service. Paste in the credential value, then click Ask Elle to apply. Elle wires the integration into your application code for you.
Custom secrets: Click + Add a new secret to add a credential for any other service. Enter a name and value, then click Save. You can ask Elle to build on the secret later.
Your application code references each credential as an environment variable. When you add, update, or remove a credential, the change takes effect the next time your application restarts in that environment.
View existing credentials
The Existing secrets table at the bottom of the page lists every credential you have added, with values masked except for the last few characters. Here, you can copy a value to your clipboard or remove a credential you no longer need.
Preview and production environments
Preview and production maintain separate sets of credentials. Add integrations to both environments if your application needs them. Use the Preview and Production toggle at the top of the page to switch between these environments.
Aha! Builder shows an extra warning before you change a production credential to help prevent disruptions for live users.