How to Connect to Folk

This guide walks you through obtaining an API key from Folk to connect your workspace.

How to Find Your API Key

Follow these steps to generate an API key in Folk:

  1. Log in to your Folk account.

  2. Navigate to your workspace settings by clicking on the settings icon or visiting https://app.folk.app/apps/contacts/network/settings/api-keys.

  3. In the left navigation menu, select API Keys under the API section.

  4. Click the Create API Key button (or similar button to generate a new key).

  5. Give your API key a descriptive name (e.g., "Apideck Integration") to help you identify it later.

  6. Copy your API Key value immediately - you'll need this for the Vault setup.

Important: Store your API key securely. Folk API keys provide full programmatic access to your workspace, including the ability to sync contacts, trigger actions, and automate workflows.

Vault Connection Setup

Enter your API key in Vault:

  • API Key - The API key you generated in Folk

Click Save to complete the connection.

You're connected now!

Authentication Method

Folk uses bearer token authentication. When you connect through Vault, your API key is automatically included in the Authorization header for all API requests:

Authorization: Bearer <your-api-key>

Permissions

Folk API keys inherit the permissions of the user who created them. Make sure the user account has appropriate access to the resources you need to interact with through the API.

Revoking API Keys

To revoke an API key:

  1. Navigate to your workspace settings
  2. Go to API Keys in the API section
  3. Locate the API key you want to revoke
  4. Click the delete or revoke option next to the key
  5. Confirm the deletion

Revoked API keys cannot be recovered - you'll need to generate a new key if needed and update your Vault connection.