> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frankieone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create new entity

## Video Guide

<iframe width="100%" height="450px" src="https://www.loom.com/embed/fcbf6e4c7c4f4f24a2c8164a198e46d6?sid=d70fe04f-9625-4bc0-8eb6-618019d35bc4&hide_speed=true&hide_share=true" frameborder="0" allowfullscreen />

The **Create new entity** screen allows you to input a customer’s personal information and run checks.

## To create a New entity via the Portal

Navigate to the Create new entity form by clicking the **+ New Entity** button.

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/aMfFq_kgPrWD4cV3/images/v2/portal/20ce07d-new_entity_button.webp?fit=max&auto=format&n=aMfFq_kgPrWD4cV3&q=85&s=246393a7dd9d3eb2ca90f71503fa53f6" width="164" height="139" data-path="images/v2/portal/20ce07d-new_entity_button.webp" />
</Frame>

### Create manually

Select **Create manually** to enter the entity profile details yourself.

### Send a link

Select **Send a link** to send a link to the customer to complete their own profile.

## Creating manually

### Select a Workflow

Select the **Workflow** you would like to apply to the new entity profile. This will determine the sequence of checks to accomplish a business process (or a part of it) that's run on this customer.

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/7CDIze6_8GRGrpBN/images/v2/portal/97bb19a-workflow_dropdown.png?fit=max&auto=format&n=7CDIze6_8GRGrpBN&q=85&s=b99c31787651d09eaf9786aff9c764be" width="289" height="157" data-path="images/v2/portal/97bb19a-workflow_dropdown.png" />
</Frame>

### Personal Info

Use the form fields to enter the customer’s personal information. Fields will be optional or required based on the workflow and your FrankieOne configuration.

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/aMfFq_kgPrWD4cV3/images/v2/portal/3146f05-image.png?fit=max&auto=format&n=aMfFq_kgPrWD4cV3&q=85&s=c4513284b0a48ab931e433fb3c4a06c1" alt="" width="914" height="397" data-path="images/v2/portal/3146f05-image.png" />
</Frame>

### Personal Information Fields

|                   |                                                                                                                                                                |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Customer ID**   | *Made up of numbers and or letters and no spacing.*<br /> <br /> Search by Customer ID using the search bar.                                                   |
| **Given Name**    | *The customer’s Given Name as shown on their ID document.*<br /> <br /> Required field for all customer profiles.<br /> <br />\* Also known as **First Name**. |
| **Middle Name**   | *Middle name is an optional field*<br /> <br /> Enter a middle name if it's shown on the customer’s ID document.                                               |
| **Family Name**   | *The customer’s Family Name as shown on their ID document.*<br /> <br /> Also known as **Surname** or **Last Name**                                            |
| **Date of Birth** | - The customer’s Date of Birth                                                                                                                                 |
| **Phone Number**  | - Optional field                                                                                                                                               |
| **Email Address** | *Optional field*<br /> <br /> Must be a valid email address format                                                                                             |

### Residential address

Use the address search field to quickly find an address and populate it into the correct fields.

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/Q0p9n7SnI12Y4IML/images/v2/portal/c8305d7-image.webp?fit=max&auto=format&n=Q0p9n7SnI12Y4IML&q=85&s=a71bb8f72b5a50be09f1ac401cf23917" alt="" width="893" height="355" data-path="images/v2/portal/c8305d7-image.webp" />
</Frame>

Or select **Enter address manually** to display the individual address fields.

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/f6e97c0-image.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=307567efec5b2fce42d4aa45514d22fc" alt="" width="633" height="160" data-path="images/v2/portal/f6e97c0-image.webp" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/aMfFq_kgPrWD4cV3/images/v2/portal/18abd9a-image.png?fit=max&auto=format&n=aMfFq_kgPrWD4cV3&q=85&s=768c487be1b359cd028f022dd717c115" alt="" width="628" height="476" data-path="images/v2/portal/18abd9a-image.png" />
</Frame>

### Add an ID Document

Click **Add New Document** to add an ID document to a customer profile.

Different **workflows** will have different requirements for the number and type of ID documents required and this will be set up in your FrankieOne configuration.

Drag and drop to **upload a document scan** or browse and select a file from your computer.

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/kuSfFEj6euwHKbOF/images/v2/portal/1035f4a-image.png?fit=max&auto=format&n=kuSfFEj6euwHKbOF&q=85&s=7d41dba5d7079d2a63a762d15e19f157" alt="" width="916" height="319" data-path="images/v2/portal/1035f4a-image.png" />
</Frame>

<Callout icon="bell" color="#FFCA16" iconType="regular">
  ##### Important

  FrankieOne keeps every version of an uploaded document, but only the latest version is available in the Portal and API. This design ensures operators make decisions using the most current evidence and avoids confusion that could occur if outdated files were shown, without their related verification results.

  Building a full historical view that links each document version to its outcome is not supported today.

  If you need to override a decision, always use the latest document, not an older version.
</Callout>

#### Consent

You must obtain **Consent** from your customer as per the **AML/CTF** act to run certain checks. You won't be able to save and verify where consent is required as part of the selected **Workflow.**

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/aMfFq_kgPrWD4cV3/images/v2/portal/1edf531-image.png?fit=max&auto=format&n=aMfFq_kgPrWD4cV3&q=85&s=a2aa5b626b6fb3accdf700dd22cd4779" alt="" width="940" height="298" data-path="images/v2/portal/1edf531-image.png" />
</Frame>

### Save & verify

Selecting **Save & verify** will save the changes to the profile and run all of the checks required as per the selected workflow. If checks have been run previously, FrankieOne will decide which, if any, further checks need to be run and which don't need to be run again.

#### Save Changes

Selecting **Save changes** will save changes to the profile and any new information or information that has been changed after checks have already been run will show as **Unchecked**.

If changes were made that don't impact the result of previous checks, these results will remain.

If a new ID document has been added and saved, and a different ID document has previously passed, the original document will remain as passed.

## Send link to create

If you selected **Send a link** when creating a new entity, you will be prompted to enter the customer’s details.

Instead of typing every detail yourself, you can text an onboarding link to the customer.
The customer opens the link, uploads their ID and selfie, and the Portal updates the profile automatically.

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/send-link-via-sms.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=878865109389889071171ccca5f386cb" alt="" width="558" height="664" data-path="images/v2/portal/send-link-via-sms.webp" />
</Frame>

### 1. Enter phone number and name

In the **Send link** modal, type the customer’s

* **Phone number** (include country code).
* **Given name** and **Family name** (optional but helps match results).

<Callout icon="thumbtack" color="#1A6CFF" iconType="regular">
  The phone number becomes the **Customer reference (Cust ref)** for easy searching later.
</Callout>

### 2. Choose the onboarding workflow

Select the **Workflow to send** from the drop-down.
Common options include **Biometrics/OCR** or **OCR only**.

### 3. Click **Next** – Choose Send Link or Copy Link

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/Q0p9n7SnI12Y4IML/images/v2/portal/confirm-and-send.webp?fit=max&auto=format&n=Q0p9n7SnI12Y4IML&q=85&s=a931b1e0c123024225e89301a5be32ea" alt="" width="569" height="481" data-path="images/v2/portal/confirm-and-send.webp" />
</Frame>

| Option        | What happens                                           |
| :------------ | :----------------------------------------------------- |
| **Send link** | Sends an SMS immediately.                              |
| **Copy link** | Copies the URL so you can paste it into email or chat. |

If  you select **Copy link**, a notification will appear to confirm the link is copied.

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/link-copied-successfully.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=0a9b8f7bde27b4df197e26ba77634c09" alt="" width="406" height="81" data-path="images/v2/portal/link-copied-successfully.webp" />
</Frame>

### 4. After you send the link

* The entity is **automatically assigned to you** for easy follow-up.
* The **phone number appears as the Cust ref** in the entity record.
* The profile status shows **Unchecked** until the customer finishes.

A notification will appear to confirm the link is sent.

<Frame>
  <img src="https://mintcdn.com/frankieone-f5583b1b/wrMv-bNl47Mu1DGf/images/v2/portal/workflow-sent.webp?fit=max&auto=format&n=wrMv-bNl47Mu1DGf&q=85&s=4e8ee48c98dff879d9c60036230b27f0" alt="" width="402" height="77" data-path="images/v2/portal/workflow-sent.webp" />
</Frame>

### Finding an incomplete entity

1. Use the **Search bar** at the top of the Portal page.
2. Select **Customer Ref** from the drop-down.
3. Paste or type the **Cust ref** (customer’s phone number).
4. Press **Enter** to open the profile.

### Resending a link

If the customer’s link expired or they had trouble:

1. Open the entity and go to **Workflow events**.
2. Click the **Send link** icon again.
3. Confirm the phone number (edit if needed) and press **Send**.
