> ## 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.

# Follow-up

> Let Truv handle email and SMS reminders when users leave without finishing verification

When a user leaves your application without finishing verification, Truv can automatically send email and SMS reminders to bring them back. Toggle notifications on and off using the order's `notification_settings`. Truv handles the messaging.

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

    App->>API: Create order (notifications suppressed)
    App->>User: User starts verification in-app
    User-->>App: User leaves without finishing
    App->>API: Update order (enable notifications)
    API->>User: Truv sends email/SMS reminders
    User->>API: User clicks link, completes verification
    API-->>App: Webhook (order-status-updated)
```

***

## How it works

1. Create the order with `suppress_user_notifications: true` while the user is in your app
2. When the user leaves without finishing, update the order to enable notifications
3. Truv sends email and SMS reminders on your behalf
4. When the user returns and completes verification, you receive a webhook

***

## Suppress notifications while user is in-app

While the user is active in your application, suppress Truv notifications. Your app controls the experience.

```bash theme={null}
curl --request POST \
     --url https://prod.truv.com/v1/orders/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "products": ["income"],
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com",
  "phone": "4155554193",
  "notification_settings": {
    "suppress_user_notifications": true
  }
}'
```

***

## Enable notifications when user leaves

When the user leaves your app without completing verification, update the order to turn on notifications. Truv takes over and sends email/SMS reminders to bring them back.

```bash theme={null}
curl --request PATCH \
     --url https://prod.truv.com/v1/orders/39aa1486ccca4bc19cda071ffc1ba392/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "notification_settings": {
    "suppress_user_notifications": false
  }
}'
```

You can also delay the first notification instead of sending it immediately.

```bash theme={null}
curl --request PATCH \
     --url https://prod.truv.com/v1/orders/39aa1486ccca4bc19cda071ffc1ba392/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "notification_settings": {
    "suppress_user_notifications": false,
    "first_notification_delay_hours": 24
  }
}'
```

***

## Configure notifications

| Field                            | Type    | Default | Description                                              |
| -------------------------------- | ------- | ------- | -------------------------------------------------------- |
| `suppress_user_notifications`    | boolean | `false` | Suppress all Truv email/SMS notifications for this order |
| `first_notification_delay_hours` | integer | `0`     | Hours to delay the first notification after enabling     |

***

## Reminders

Truv automatically sends an initial notification and up to three reminders via email and/or SMS. Each reminder includes the original order link. Reminders are distributed evenly from order creation until expiration. Once an order reaches a terminal status (completed, canceled, expired), reminders stop.

<Note>
  SMS reminders require account-level enablement. Contact [support@truv.com](mailto:support@truv.com) to activate. SMS reminders are only sent between 10am–6pm ET.
</Note>

| Link Expiration | Order Lifespan       | Initial Notification | Reminders                                              |
| --------------- | -------------------- | -------------------- | ------------------------------------------------------ |
| 1 day           | 24 hours + weekends  | 30 seconds           | 1st: 6 hours<br />2nd: 16 hours<br />3rd: 22 hours     |
| 2 days          | 48 hours + weekends  | 30 seconds           | 1st: 6 hours<br />2nd: 24 hours                        |
| 3 days          | 72 hours + weekends  | 30 seconds           | 1st: 24 hours<br />2nd: 48 hours<br />3rd: 66 hours    |
| 1 week          | 168 hours + weekends | 30 seconds           | 1st: 24 hours<br />2nd: 72 hours<br />3rd: 120 hours   |
| 2 weeks         | 336 hours + weekends | 30 seconds           | 1st: 96 hours<br />2nd: 192 hours<br />3rd: 288 hours  |
| 3 weeks         | 504 hours + weekends | 30 seconds           | 1st: 264 hours<br />2nd: 384 hours<br />3rd: 456 hours |
| 4 weeks         | 672 hours + weekends | 30 seconds           | 1st: 312 hours<br />2nd: 432 hours<br />3rd: 624 hours |

Order expiration periods exclude weekends, but reminders continue being sent during weekends. Customize expiration times and reminder schedules in the [Truv Dashboard](https://dashboard.truv.com).

<Tip>
  Combining email and SMS improves completion rates. High-intent borrowers complete over 50% of verifications within 2 hours.
</Tip>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Data Refresh" icon="arrows-rotate" href="/developers/integration/embedded-orders/data-refresh">
    Pull updated data without user re-authentication
  </Card>

  <Card title="Self-Certification" icon="clipboard-check" href="/developers/integration/embedded-orders/self-certification">
    Let users review and confirm retrieved data
  </Card>

  <Card title="Webhooks" icon="webhook" href="/api-reference/webhooks">
    Receive notifications when order status changes
  </Card>
</CardGroup>