> For the complete documentation index, see [llms.txt](https://help.metaforms.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.metaforms.ai/survey-programming-decipher/unified-flow/connect-metaforms-to-decipher.md).

# Connect Metaforms to Decipher

To integrate Metaforms with Decipher, the setup happens in two layers:

1. **Connect your Decipher instance(s)** (organization-level)
2. **Add user API keys to a specific instance** (user-level)

## Connect Your Decipher Instance(s)

If your organization uses multiple Decipher environments (EU, UK, US, etc.), you must first register them in Metaforms.

> This is a one-time setup per instance.

Follow the steps below to connect your Decipher account to Metaforms.

**Step 1: C**lick on the **Manager's Dashboard**

<figure><img src="/files/jgoxdJ0RlojPtuNRbjxu" alt=""><figcaption></figcaption></figure>

**Step 2:** In the Integrations tab, click on "New Account"

<figure><img src="/files/g5xwyDR5X19araujBXy6" alt=""><figcaption></figcaption></figure>

**Step 3:** In the dialog, enter the Account Name (which can be internal classifications for teams/instances) and the corresponding Decipher Domain for that instance (example: your EU team's Decipher server domain could be eu.your-company-domain.com), and then click on "Create Account"

<figure><img src="/files/Fxgo9Tf20sdG8IcWjwA4" alt=""><figcaption></figcaption></figure>

## **Add user API keys to a specific instance**

API Keys enable syncing the generated XML code on Metaforms to your Decipher project and vice-versa.

* The **roles and access permissions in Metaforms** only control access *within Metaforms*.
* To sync data between Metaforms and Decipher, the user must have a valid **Decipher API key** with the necessary permissions.
* Decipher uses **user-level** API keys, there are **no org-level or project-level** keys.
* A user’s **API key inherits their Decipher permissions**.
* Hence, each user must generate and add their own API key **for every Decipher instance they want to sync and work with.**

Follow the steps below to generate and configure your API key:

### :wrench: Generate your Decipher key

* **Log in** to your [Decipher](https://singapore.decipherinc.com/login) account.
* Click your **User ID** in the top-right corner.
* Select **API Access** from the dropdown menu.

<figure><img src="/files/D7Au9JgSGwLV5jceuSn6" alt=""><figcaption></figcaption></figure>

* Click **Create New API Key**.

<figure><img src="/files/h2taJ0xKgfXsyguiXIlL" alt=""><figcaption></figcaption></figure>

* In the prompt:
  * **What User?** → Type **self**
  * **Any Restrictions?** → Leave blank (unless specific restrictions are required).
* Your new **API Key** will appear in a pop-up window.

{% hint style="info" %}
**Important:** Copy and store this key securely. It is **only shown once** during creation.
{% endhint %}

### :link: Add API Key to Metaforms

1. **Log in** to your Metaforms account.
2. Navigate to **Settings > Integrations** page.
3. Selecting the specific Decipher Instance, click on **Set Key** next to your email address in the top bar.

<figure><img src="/files/empO6a5hgicvjdVvKBVX" alt=""><figcaption></figcaption></figure>

1. **Paste** the API Key into the pop-up dialog.
2. Click **Verify and Save**.

Once done, your Metaforms account is successfully linked to Decipher, and project syncing can begin.

## :bulb: Recommended Workflow for Metaforms + Decipher

**🔄 First-Time Setup**

Admins:

1. Add all required Decipher instances in Metaforms
2. Replicate Decipher user groups by creating corresponding **User Groups** in Metaforms.

Each user:

1. Identifies which instance(s) they work with
2. Generates API key(s) for those instance(s)
3. Adds them under the correct instance in Metaforms

**📁 During Project Creation**

1. Create the project in Metaforms (from scratch or by importing from Decipher).
2. Go to the **Overview** tab of the new project in Metaforms and assign the appropriate **User Groups**.
3. Open the same project in Decipher, go to its **Overview** page, and assign the corresponding **Decipher user groups**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.metaforms.ai/survey-programming-decipher/unified-flow/connect-metaforms-to-decipher.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.