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: Click on the Manager's Dashboard

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

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"

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:

🔧 Generate your Decipher key

• Log in to your Decipher account.

• Click your User ID in the top-right corner.

• Select API Access from the dropdown menu.

• Click Create New API Key.

• 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.

Important: Copy and store this key securely. It is only shown once during creation.

🔗 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.

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.

💡 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.