# Create your organization and invite employees

An organization ("org") represents your company or project. It holds your wallets, policies and user credentials.&#x20;

## Create your organization

{% stepper %}
{% step %}

### Create your account and organization

Go to [app.dfns.io/get-started](https://app.dfns.io/get-started) to create a new organization with you as the first Employee, you will be registered as the first admin.

<figure><img src="https://3953120539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtnSPOZGQ2hBmgoVWX5H6%2Fuploads%2FGGMcvZivDGooujUG4MoZ%2FCreate%20Account%201%20.png?alt=media&#x26;token=153b5fcb-d857-4b74-941b-040e91e05c6c" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Get your registration code

You should have received an email with a link and a code to register in our system.

<figure><img src="https://3953120539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtnSPOZGQ2hBmgoVWX5H6%2Fuploads%2FYqNJnLtA7c84u0yrYIU1%2FScreenshot%202025-03-11%20at%2016.59.24.png?alt=media&#x26;token=a82880a1-d22c-43f3-bfd5-0f5dc7db427f" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Activate your account**

Click on the link in the Email and enter the registration code. You can already see your organization id.&#x20;

<figure><img src="https://3953120539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtnSPOZGQ2hBmgoVWX5H6%2Fuploads%2FHktqCNIq3CGvUZrT8ZqI%2FScreenshot%202024-08-28%20at%201.46.34%E2%80%AFPM.png?alt=media&#x26;token=20fb09a2-9172-464c-ae47-ffc3067880be" alt="" width="328"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Create a passkey**

You will be asked to register your :key: passkey. Your browser should offer the available options on your device. If there is none, then you can consider buying a WebAuthn-compatible device (Yubikeys are a common example) or install a password manager to take care of it for you.&#x20;

{% hint style="info" %}
Passkeys eliminate the need for passwords and use your device’s built-in security features, like Face ID, Touch ID, or a PIN.
{% endhint %}

<figure><img src="https://3953120539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtnSPOZGQ2hBmgoVWX5H6%2Fuploads%2Fj9gMNFwsuv1OKG6MtoSK%2FScreenshot%202025-02-26%20at%2013.49.15.png?alt=media&#x26;token=ae6f6fe2-c7c6-419b-be46-69830c7d26f3" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Save your recovery keys**

Last step is to print or save your recovery details in a safe place.

{% hint style="info" %}
Some characters may be difficult to differentiate depending on the font used (uppercase i vs lowercase L, etc). Make sure you store or print them with a font that clearly shows the difference!
{% endhint %}

<figure><img src="https://3953120539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtnSPOZGQ2hBmgoVWX5H6%2Fuploads%2F0709PmDreQmgcLGC0X16%2FCapture%20d%E2%80%99e%CC%81cran%202025-07-10%20a%CC%80%2018.40.40.png?alt=media&#x26;token=d79e4c29-991f-4ff6-9bcd-b486bf1bd5af" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="success" %}

#### Congratulations! You are now registered are able to log in to the dashboard!

{% endhint %}

## Invite other employees

{% stepper %}
{% step %}

### Open the Users page

On the dashboard, head to Org > Users (direct link: <https://app.dfns.io/v3/org/users>).

Notice that you are on your own right now, and you are an Admin :tada:&#x20;

The new users will be allowed to connect to the dashboard and use the API following the permissions you will grant them (they will have no permission when you will create them).&#x20;

<figure><img src="https://3953120539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtnSPOZGQ2hBmgoVWX5H6%2Fuploads%2Flw6WPzGtlsOvYqW0FyMF%2FCapture%20d%E2%80%99e%CC%81cran%202025-07-15%20a%CC%80%2016.13.34.png?alt=media&#x26;token=0eb3a7d9-3645-4593-b0fa-74056c019bf4" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Create a new user

Add Users to the organization by clicking “New User”. The type of user is always Employee here, as those are your colleagues aiming at using Dfns dashboard and APIs. If you want to onboard your customers as user, then head to [delegated-auth](https://docs-legacy.dfns.co/d/api-docs/authentication/delegated-auth "mention"). Note: ExternalID is optional.

When you have filled in the information, hit Create. As this is a modification in your org, you will be requested to :key: sign the action with your passkey before it's actually executed.

{% hint style="info" %}
The new user will receive an email with the same registration flow as you did. Make sure he follows the instructions to register his credentials to be able to use Dfns.
{% endhint %}

<figure><img src="https://3953120539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtnSPOZGQ2hBmgoVWX5H6%2Fuploads%2Fgd9wAh2koCdeXUtQifHo%2FCapture%20d%E2%80%99e%CC%81cran%202025-07-15%20a%CC%80%2016.24.55.png?alt=media&#x26;token=71c586e3-9509-4f84-b166-a76ca4581b19" alt="" width="375"><figcaption></figcaption></figure>

Once done, you are given an overview of this new user:

<figure><img src="https://3953120539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtnSPOZGQ2hBmgoVWX5H6%2Fuploads%2FkNLK2aakVqxc8vfCZBsb%2FCapture%20d%E2%80%99e%CC%81cran%202025-07-15%20a%CC%80%2017.12.10.png?alt=media&#x26;token=839966da-4435-4aaf-be31-17e585a2b930" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### (Optional) Assign a Permission

The Org Owner creates and assigns the necessary permissions to allow users access the parts of the system required for their job responsibilities.&#x20;

Once the user details page, click "Add Permission" and select the one most relevant. Confirm the Permission Assignment and :key: sign the action with your passkey.&#x20;

{% hint style="info" %}
Two permissions are already created for you with the most common needs: full admins can do everything while end users can simply make transactions.&#x20;

This is for convenience mostly, but we strongly encourage implementing the principle of least privilege by setting up your own permissions in the dashboard.&#x20;
{% endhint %}

<figure><img src="https://3953120539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtnSPOZGQ2hBmgoVWX5H6%2Fuploads%2Fu4jZHFIotnP4OpO2iibV%2FCapture%20d%E2%80%99e%CC%81cran%202025-07-15%20a%CC%80%2017.17.51.png?alt=media&#x26;token=69cda702-c24e-4577-b19f-d6aa9828fefd" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

You can now head to the next step:&#x20;

{% content-ref url="define-and-assign-permissions" %}
[define-and-assign-permissions](https://docs-legacy.dfns.co/d/getting-started/onboarding-to-dfns/define-and-assign-permissions)
{% endcontent-ref %}
