Skip to Content
Getting StartedQuick Start Guide

Quick Start Guide

This guide walks you through the first steps in Digital Trust Foundry after your tenant has been created. It assumes you are a tenant administrator and have set up Foundry Wallet from your invite email (see Getting Your Tenant).

1. Sign In to Your Tenant

Go to your tenant URL:

https://your-tenant.digitaltrustfoundry.com

The sign-in page opens on wallet sign-in:

  • Browser extension: If the Foundry Wallet extension in this browser is unlocked and connected to your account, click Sign in with your wallet (or Continue as followed by your name) and approve the signature in Foundry Wallet.
  • iPhone app: If there is no extension in this browser, or it is locked or not connected to your account, the page shows a QR code. Scan it with the Foundry Wallet iPhone app and approve the sign-in there.

Accounts without a wallet sign in with a password: click Sign in as a different user, then enter your Username and Password. Once a wallet is connected to an account, password sign-in is refused for that account.

If you lose access to your wallet, click Request access next to Lost access to your wallet? on the sign-in page. Your administrator can then email you a link to reconnect it.

2. Register Your Enterprise

Your enterprise is your organization’s identity and the source of all signing authority in your tenant.

  1. Open Enterprises in the sidebar (administrators only) and click Register enterprise.
  2. Enter the Legal Name and Jurisdiction (both required). You can also enter your LEI and choose an Enterprise Type: Root, Subsidiary or Branch. A subsidiary or branch also needs a Parent Enterprise.
  3. Click Register enterprise. If your account signs with Foundry Wallet (the default for the first administrator), approve the request in Foundry Wallet to finish.

The platform creates the enterprise’s identifier (AID) and lists the enterprise under Enterprises. If you entered an LEI, the enterprise page offers Request vLEI, which requests a vLEI credential for the enterprise from a vLEI test network.

3. Add Users

  1. Open Users in the sidebar (administrators only) and click Add User.
  2. Enter the First Name, Last Name, Username (used to sign in) and Email Address, and choose a Role: Full platform administration or Wallet access.
  3. Under Apps, apps open to everyone are already included. Choose any apps that are limited to named people.
  4. Click Create user.

Users created here sign with Foundry Wallet. Each one receives an email titled “Set up your Foundry Wallet” with a link that works once and is valid for 7 days. The confirmation dialog also shows the setup link, so you can share it if the email is slow to arrive. A user must connect Foundry Wallet before they can sign or be assigned as an officer.

4. Assign Officers

Officers sign on behalf of the enterprise.

  1. Open Enterprises, open your enterprise and go to the Officers tab.
  2. Click Assign Officer. Find the user under Search User, enter an Officer Role (for example CEO or Authorized Signatory) and choose an Authority Level. You can also set an Authorization Scope, Valid From and Valid Until (Optional).
  3. Leave Create KERI delegation chain selected and click Assign Officer. If your account signs with Foundry Wallet, approve the request in Foundry Wallet.

Each officer receives signing authority directly from the enterprise. The delegation is recorded as a verifiable chain, which you can review on the Delegation Chain tab.

5. Generate an API Key

For programmatic access to the platform:

  1. Open Integrations in the sidebar (administrators only), then the API keys tab, and click Generate key.
  2. Enter a Name and choose a Role. The default role, Read only, can read Trustables but cannot create them, so choose Integration for the example in step 6. The form lists what each role grants. The key expires after one year unless you choose otherwise.
  3. Click Generate key and copy the key from the dialog. Store it securely: it won’t be shown again.
  4. Send the key in the Authorization: Bearer header of your API requests.

To connect Salesforce, ServiceNow, Microsoft Dynamics 365 or the Claude Code Connector, enable its connector on the Connectors tab instead. See Integrations.

API base URL: https://your-tenant.digitaltrustfoundry.com/api/v1

See the Developer Guide for full API documentation.

6. Create Your First Trustable

A Trustable is a piece of content wrapped with verifiable trust metadata.

In the Platform

  1. In the sidebar, expand the Development group and open Trustables.
  2. Click Create trustable.
  3. Enter a Description, choose a Content Type and choose a Signer. To attach structured data, open Advanced options and fill in Content (JSON, optional).
  4. Click Create trustable.

If the signer signs with Foundry Wallet, the request appears in their wallet and the Trustable is signed when they approve it. If the signer uses platform-held (custodial) keys, the platform signs it for them.

Via the API

Trustable creation requires a structured request describing content, schema, lifecycle, publication policy and signing authority. See the Trustables API reference for the full field-by-field shape. Authenticate with the API key from step 5:

curl -X POST https://your-tenant.digitaltrustfoundry.com/api/v1/trustables \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d @trustable.json

The resulting Trustable carries a cryptographic signature, a SAID (Self-Addressing Identifier) for tamper evidence, and a verifiable chain of authority back to your enterprise identity.

7. Foundry Wallet

Foundry Wallet keeps a user’s signing keys on their own device. It comes in two forms:

  • Browser extension: for Chrome, Edge and Brave on a computer, installed from the Chrome Web Store
  • iPhone app: from the App Store, locked by Face ID or the device passcode

https://wallet.digitaltrustfoundry.com/get takes you to the right one for your device.

Users set up Foundry Wallet from the link in their invite email: they install the wallet, create a passphrase in the extension (the iPhone app needs none), then open the link and click Connect Foundry Wallet. From then on, signing requests assigned to them appear in Foundry Wallet for approval, and their private keys never leave their device. See Foundry Wallet for full setup details.

What’s Next?

Getting Your TenantKERI Deep Dive
Quick Start Guide | Digital Trust Foundry Docs