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

# Connect and Onboard Your Organization to Tavryn AI

> Connect your organization, import your SaaS and cloud contracts, set your spending policy, and provision a Circle USDC treasury wallet on Arc Testnet.

Onboarding registers your organization with Tavryn and gives the autonomous procurement agent everything it needs to start auditing waste, negotiating renewals, and settling payments in USDC. The process takes under five minutes: you supply your business name, import your existing subscriptions through one of three ingestion modes, configure a deterministic spending policy, and confirm. Tavryn then provisions a Circle Developer-Controlled Smart Contract Account (SCA) wallet for your organization on Arc Testnet — the on-chain address where escrowed USDC is held during every negotiated settlement.

### Navigate to /onboard

Open your Tavryn instance and go to `/onboard`. If you are already logged in, the page is also reachable from the dashboard sidebar under **Organizations → Onboard New**.

The page provides two quick-start shortcuts at the top right — **Try Sample Statement CSV** and **Try Sample Invoice PDF** — that pre-load realistic demo data so you can walk through every step without uploading real documents.

### Enter your business name

Type your company or organization name in the **Company / Organization Name** field. This name appears throughout the dashboard, on approval notifications, and on every public savings receipt your organization generates.

### Set your initial treasury balance

Enter the amount of USDC you plan to hold in your Arc Testnet treasury wallet in the **Initial Treasury Balance** field. The default is `50,000 USDC`. This figure is used by the policy engine to sanity-check that sufficient funds exist before the agent escrows a payment.

> [!TIP]
>
> If you are evaluating Tavryn on testnet, set any balance you like here — then
> top up the actual on-chain wallet afterward using the Circle testnet faucet at
> [faucet.circle.com](https://faucet.circle.com). Select the **Arc** network and
> paste your wallet address (displayed after you confirm onboarding).

### Choose an ingestion mode

Select how you want to import your existing subscriptions. Tavryn supports three modes:

> [tab] Statement / Invoice
>
> Upload a **PDF invoice** or a **CSV bank statement** and let the AI extraction engine detect recurring subscription charges automatically.
>
> * **Accepted formats:** PDF (invoices, order confirmations), CSV (bank or card statements with Date, Description, and Amount columns), PNG/JPG (scanned invoices)
> * **Maximum file size:** 10 MB
> * **What happens:** Tavryn parses the file, calls the AI extraction layer to identify recurring vendor charges, and populates a review table with every detected subscription. Each row shows the vendor name, annual price estimate, renewal date, and a confidence score. Rows flagged `needsConfirmation` are highlighted — review and correct them before continuing.
>
> This mode is the fastest path from zero to a fully populated contract list. Upload a 12-month bank statement CSV and Tavryn will detect every SaaS and cloud charge in seconds.

> [tab] CSV Bulk Import
>
> Upload a structured CSV file that already conforms to Tavryn's standard subscription format. Use this mode when you have an existing procurement spreadsheet or a list exported from your finance system.
>
> The file must include the following columns (header names are case-insensitive):
>
> | Column | Required | Description |
> | - | - | - |
> | `vendor` | ✅ | Vendor company name |
> | `service` | ✅ | Product or service name |
> | `category` | ✅ | `software`, `cloud`, or `contractors` |
> | `annual_price` | ✅ | Annual price in USD (numeric, no symbols or commas) |
> | `renewal_date` | ✅ | ISO date: `YYYY-MM-DD` |
> | `seats` | Optional | Total provisioned seats |
> | `active_seats` | Optional | Seats with active logins |
>
> ```csv theme={null}
> vendor,service,category,annual_price,renewal_date,seats,active_seats
> Slack,Messaging Platform,software,12000,2025-03-01,100,62
> Datadog,Monitoring,software,18000,2025-04-15,50,48
> AWS,Cloud Infrastructure,cloud,45000,2025-06-01,,
> ```
>
> Every row is validated against the subscription schema on upload. Invalid rows surface inline errors in the review table — correct them before proceeding to the next step.

> [tab] Manual Entry
>
> Add contracts one by one using the manual entry form. Fill in each field, then click **Add Subscription** to append the row to the review table.
>
> | Field | Notes |
> | - | - |
> | **Vendor** | Required — e.g., `Notion` |
> | **Service** | Required — e.g., `Team Plan` |
> | **Category** | `software`, `cloud`, or `contractors` |
> | **Annual Price** | Must be greater than \$0 |
> | **Renewal Date** | Use `YYYY-MM-DD` format |
> | **Seat Count** | Optional — total provisioned seats |
> | **Active Seats** | Optional — seats with confirmed usage; must not exceed Seat Count |
>
> Use manual entry to add a single critical contract quickly, or combine it with an uploaded file to fill in contracts the parser missed.

### Configure your spending policy

Before committing, set the deterministic policy rules that govern how much the agent can spend autonomously and when it must escalate to a human.

| Policy Field | Default | Description |
| - | - | - |
| `max_auto_transaction` | **\$2,000** | Maximum single transaction the agent executes without a human signature |
| `min_savings` | **\$200** | Minimum projected annual savings required before the agent opens a negotiation |
| `human_approval_required_above` | **\$2,000** | Transactions above this threshold generate a 1-tap HMAC approval link sent to your supervisor |
| `allowed_categories` | **software, cloud, contractors** | Category types the agent is permitted to negotiate |

> [!NOTE]
>
> The policy engine runs as deterministic TypeScript — no language model has any
> ability to approve, modify, or bypass these rules. You can adjust these values
> after onboarding at any time from the **Settings** page.

### Review and add your first contracts

After importing, inspect the **Subscriptions Review Table**. Each row displays the parsed fields alongside any validation errors. You can:

* **Edit** any field inline by clicking it
* **Exclude** a row by toggling the checkbox — excluded rows are not committed
* **Remove** a row permanently with the delete action

The summary bar at the bottom shows the total number of valid, included rows and the combined annual spend. You need at least one valid, included subscription to proceed.

### Confirm onboarding

Click **Commit Organization & Contracts**. Tavryn sends the payload to `/api/onboard`, which:

1. Creates your organization record and enforces data isolation between organizations
2. Saves your spending policy
3. Inserts all included contracts
4. Calls the Circle Developer-Controlled Wallets SDK to provision a new Smart Contract Account (SCA) wallet for your organization on **Arc Testnet** (Chain ID `5042002`)

On success, you are shown the **Funding Result** card with:

* Your organization's Circle SCA wallet address
* Network details (Arc Testnet, Chain ID, RPC URL)
* A direct link to your wallet on ArcScan
* Instructions for topping up with testnet USDC

> [!TIP]
>
> Fund your new wallet at [faucet.circle.com](https://faucet.circle.com).
> Select the **Arc** network, paste your wallet address, and request testnet
> USDC. The agent will alert you on your notification webhook when the balance
> drops below 100 USDC.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.