> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convocore.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Connect Voiceflow to Convocore with a project API key or a personal access token, plus the Project ID.

Convocore accepts two Voiceflow credentials. Paste either one into the Voiceflow API key field.

| Credential | Prefix | Where to create it | Also required |
| - | - | - | - |
| Project API key | `VF.DM...` | Open the project → Settings → API keys | Project ID is optional (used for transcripts) |
| Personal access token | `vfp_...` | Voiceflow Settings → Access tokens | **Project ID** from Settings → General → Metadata |

The import wizard only uses the credential to read the project. It is not stored.

## Personal access token

1. Open [Voiceflow Creator](https://creator.voiceflow.com/).
2. Go to **Settings → Access tokens**.
3. Create a personal access token and copy it immediately. It starts with `vfp_` and is shown once.

A personal token acts as your Voiceflow user. It is not limited to one project, so Convocore also needs the Project ID.

## Project ID vs Version ID

Copy **Project ID** from the project **Settings → General → Metadata**.

Do **not** copy the id from the creator URL (`creator.voiceflow.com/project/<id>/...`). That value is the **Version ID**.

| Field | Example | Use in Convocore |
| - | - | - |
| Project ID | `6aac38d57fa9503f37a88cb8` | Integrations and Import |
| Version ID | `6aac38d57fa9503f37a88cb9` | Creator URL only |

## Environment alias

| Project type | Alias to use |
| - | - |
| New projects with Environments | `main` |
| Older canvas projects | `production` or `development` |

## Knowledge base

A `vfp_...` token can list knowledge-base documents only on a project that has Environments. Canvas projects without Environments still show folders in Creator, but Voiceflow's API does not return the files. In that case:

* Import the agent with a `VF.DM...` project API key, or
* Enable Environments on the Voiceflow project, then import again with the personal token, or
* Add the documents manually in Convocore.

See [Voiceflow overview](/integration/Voiceflow/overview) for the rest of the integration.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.