Importing Fireblocks into Cryptio

This guide walks you through connecting your Fireblocks account to Cryptio so you can start importing vaults and transaction data. You can set up multiple Fireblocks integrations if needed: the steps are the same for each one.

Step 1: Create an API User in Fireblocks

To integrate Fireblocks with Cryptio, you’ll need an API user in Fireblocks with read-only permissions. This ensures Cryptio can import your vaults and transactions without introducing security risks.

1. Log in to the Fireblocks Console.

2. Navigate to Developer Center → API Users.

3. Select Add API User.

4. Complete the fields:

   • Name: Enter a descriptive name (e.g., “Cryptio Integration”).

   • Role: Choose Viewer. (This role gives Cryptio read-only access and prevents it from creating or signing transactions.)

   • CSR File: Attach a Certificate Signing Request (CSR) file.

     • If you are using Cryptio’s CSR file (recommended), download it here. This simplifies setup, and you won’t need to enter an API secret later.

     • If you prefer to use your own CSR file, your engineering team will need to generate one with OpenSSL and provide both the API key and secret when connecting with Cryptio.

5. Submit the request. The API user will require approval from your Fireblocks workspace Owner and Admin Quorum.

6. Once approved, return to Settings → Users and copy the API Key for this new user.

Tips to Avoid Connection Errors

• Check your Fireblocks region: Fireblocks has multiple environments. If you create your API user in the EU console, you must also select EU in Cryptio when connecting. (Check your Fireblocks URL—if it starts with eu- or eu2-, you’re in a European region.)

• Verify the API key format: It should look like this:

  • ef56bb41-2bdb-4bc9-b986-78813f9616b8

• CSR file options:

  • Using Cryptio’s CSR file → Only the API key is required in Cryptio (simplest option).

  • Using your own CSR file → Both API key and secret are required.

Step 2: Connect Fireblocks to Cryptio

1. In Cryptio, go to Sources from the left navigation bar.

2. Select Fireblocks and click Connect.

1. Enter the API Key (and API Secret, if applicable).

2. Enter your Account name. This is not linked to the connecting process and can be anything you want. It is mostly useful to differentiate your multiple Fireblocks accounts, when connecting more than one.

3. Choose your automation preferences:

   • Import hidden vaults

   • Set scheduler

   • Auto-import vaults

   • Import transactions on update

     (You can change these settings later.)

Step 3: (Optional) Set Up Webhook Integration

Webhooks allow Fireblocks to notify Cryptio of changes in real time.

To enable this:

1. Log in to your Fireblocks Console.

2. Go to Settings → Webhooks.

3. Add Cryptio’s webhook endpoint.

4. Paste the Webhooks URL that you can copy from your Fireblocks Integration settings in Cryptio directly, in the same setup box from Step 2.

If you don’t want to or can’t use webhooks, you can skip this step—data will still sync when you run imports.

Step 4: Finalise Setup

1. Select Connect at the bottom of the screen same setup box from Step 2 (and 3).

2. Import selected or all vaults.

3. Use the settings in the Fireblocks tab to regularly monitor vaults that need to be imported and updated.

Next Steps

Now that you’ve set up the integration, you can start using the Fireblocks module in Cryptio to manage large vault volumes, track on-chain statuses, and bulk update vault data.