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

# New Order

> Create a verification order through the Truv Dashboard without writing any code

Create orders directly in the Truv Dashboard. No API integration required. Enter the user's details, select a product, and Truv sends an email or SMS with a link to complete verification.

<Tip>
  Providing both email and phone maximizes success rates. High-intent users complete over 50% of verifications within 2 hours.
</Tip>

```mermaid theme={null}
sequenceDiagram
    participant Dashboard as Truv Dashboard
    participant API as Truv API
    participant User as User

    Dashboard->>API: 1. Create Order
    API->>User: 2. Email/SMS with verification link
    User->>API: 3. User clicks link, connects accounts
    API-->>Dashboard: 4. Status updates in Dashboard
```

***

## Create an order

1. Go to **Activity > Orders** in the [Dashboard](https://dashboard.truv.com) and click **Create Order**

<img src="https://mintcdn.com/truv/EPZ3fgmRiGhZ9lyi/images/orders-table.png?fit=max&auto=format&n=EPZ3fgmRiGhZ9lyi&q=85&s=41c4f536603268772bce147ea4ecb4d4" alt="Dashboard - Orders" width="1800" height="1188" data-path="images/orders-table.png" />

2. Select the product type (income, employment, assets)
3. Enter applicant details. First and last name are required.
4. Choose how to reach the user: send via email, SMS, or generate a shareable link

<img src="https://mintcdn.com/truv/Yx9snzfprawT6_qt/images/create-order-dashboard.png?fit=max&auto=format&n=Yx9snzfprawT6_qt&q=85&s=12721a2ce3dfa8662e7711b2ff376b80" alt="Dashboard - Create an order" width="1800" height="1188" data-path="images/create-order-dashboard.png" />

5. Click **Create**. Truv sends the notification automatically.

### Required fields

| Field          | Description                   |
| -------------- | ----------------------------- |
| `First name`   | User's first name             |
| `Last name`    | User's last name              |
| `Product type` | Income, employment, or assets |

### Recommended fields

| Field          | Description                                                                                                                             |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `Email`        | User's email for notifications                                                                                                          |
| `Phone`        | User's phone for SMS notifications                                                                                                      |
| `SSN`          | Social security number (4 or 9 digits). Used for identity matching.                                                                     |
| `Loan number`  | Loan identifier for tracking                                                                                                            |
| `Employer`     | Pre-fill employer info to skip search (up to 5 employers)                                                                               |
| `Template`     | [Customization template](/developers/customization) for branding                                                                        |
| `Custom field` | Custom metadata field to associate with the order. Configure custom fields in your [customization template](/developers/customization). |

<Note>
  If both email and phone are left blank, Truv cannot send notifications. Retrieve the verification link from the order details and share it manually.
</Note>

***

## Track order status

After creating an order, track its progress directly in the Dashboard. The order card shows the current status, notification history, and connection results.

<Tip>
  Subscribe to email alerts for order status changes in **Settings > Notifications** to get notified when orders complete or fail without checking the Dashboard.
</Tip>

| Status        | Description                                      |
| ------------- | ------------------------------------------------ |
| **Pending**   | Order created, system processing                 |
| **Sent**      | Email or SMS sent to the user                    |
| **Completed** | User connected their account                     |
| **Error**     | Notification delivery failed                     |
| **Canceled**  | Order manually canceled                          |
| **Expired**   | Order exceeded its expiration window             |
| **Skipped**   | User opened the link but did not complete        |
| **No Data**   | User connected but the provider returned no data |

***

## Set expiration and reminders

The default expiration window is **72 hours**, configurable from 1 day to 12 weeks. Expiration periods do not count weekends. Configure expiration and automatic reminders in the [Dashboard](/developers/dashboard) under **Customization**.

***

## View results

Once the user completes verification:

1. Open the order in **Activity > Orders**
2. View employer data, income, and employment details
3. Download PDF reports for each verified employer
4. Export data as needed

<img src="https://mintcdn.com/truv/vd0qdUd6laBF3m3V/images/dashboard-order-details.png?fit=max&auto=format&n=vd0qdUd6laBF3m3V&q=85&s=df9bef80c832dc8754fcf87dd302ad85" alt="Dashboard - Order details" width="1800" height="1188" data-path="images/dashboard-order-details.png" />

***

## Next steps

<CardGroup cols={2}>
  <Card title="Manage Orders" icon="table" href="/developers/integration/manual-orders/manage-orders">
    Filter, search, and export order data
  </Card>

  <Card title="CSV Upload" icon="file-csv" href="/developers/integration/manual-orders/csv-upload">
    Create orders in bulk via CSV
  </Card>

  <Card title="Dashboard" icon="gauge" href="/developers/dashboard">
    Full Dashboard overview and backend integration
  </Card>
</CardGroup>
