Fountain: How do I link my account?

Fountain One connects to Kombo using an OAuth Client ID and Client Secret. Because the keys are tied to a Fountain integration that you assign a role to, you control exactly which permissions Kombo is granted.

Prerequisites

You need a Fountain One account with admin access to Settings → Integrations & API Keys. If you don't see this option, ask your Fountain administrator to grant you access or to create the API keys for you.

Instructions

1. Open Settings

1. Log in to Fountain.
2. Click your account name in the bottom-left corner.
3. Click Settings.

2. Open Integrations & API Keys

1. In the settings list, find the Workflows group.
2. Click Integrations & API Keys.

3. Add an integration

1. Click Add integration in the top-right corner.
2. Enter a Name (for example, Kombo).
3. Select the Role that will be assigned to this integration's API keys. This role determines the permissions Kombo will have — choose one scoped to what you want to share.
4. Click Add.

4. Create API keys

1. Find your new integration in the list.
2. Click the … (more actions) menu on its row and select Manage API keys.
3. Click Add, give the key a name, and click Create.

5. Copy the Client ID and Client Secret

1. Copy the Client ID and Client Secret shown in the dialog.
2. Keep them somewhere safe — you'll paste them into the Kombo connection flow next.

Connecting in Kombo

1. Open the Kombo connection link you received (from the Kombo Dashboard or your integration partner).
2. Search for Fountain and select it.
3. When asked which version you're connecting, choose Fountain One (New).
4. Paste your Client ID and Client Secret into the corresponding fields.
5. Click Set up integration.

If the setup completes successfully, your Fountain account is now connected.

Troubleshooting

• Invalid credentials — Make sure the Client ID and Client Secret are copied in full with no extra spaces. The secret is non-recoverable, so if in doubt, create a new API key and try again.
• Missing permissions after connecting — The role assigned to the integration may be too restrictive. Assign a role that covers the data Kombo needs, then reconnect.
• Wrong version — If you use a private API key from Company Settings rather than Integrations & API Keys, connect with the Fountain (legacy) option instead.

Fountain (legacy) — private API key

Only use this if your account does not have Integrations & API Keys under Settings.

1. Log in to the Fountain dashboard.
2. Click your account name in the top-right corner and select Company Settings.
3. Under Developer Settings, click API, then Show API Keys.
4. Copy the private API key listed under Primary Key.
5. In the Kombo connection flow, choose Fountain (legacy), enter your tenant URL and the private API key, then click Set up integration.