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

# Kyriba

> Send bank statements from Kyriba to Stuut through the Kyriba API.

If your company uses Kyriba to collect statements from your banks, Stuut can read those statements directly from Kyriba. You don't have to set up each bank separately. Stuut imports the transactions into Cash App so payments can be matched to open invoices.

| | |
| - | - |
| **Integration method** | Kyriba API (prebuilt) |
| **Data cadence** | Stuut runs your export templates every hour |
| **Authentication** | A Kyriba API client (client ID and secret) that your Kyriba admin creates. No user login is shared with Stuut. |
| **File formats** | BAI2, MT940, or CAMT.053 |

## What gets synced

| Data | Details |
| - | - |
| **Bank transactions** | The statement transactions returned by the Kyriba export templates you share with Stuut, across every bank account those templates include. |

## How syncing works

Stuut uses Kyriba's export templates (process templates) to get your statements.

1. Every hour, Stuut runs each template you've shared.
2. Kyriba builds the statement file, and Stuut downloads it.
3. Stuut reads the BAI2, MT940, or CAMT.053 file and imports any transactions it hasn't seen before.

> [!NOTE]
>
> Kyriba templates return the statements Kyriba holds for the current day, and they don't accept a date range. Stuut can't pull past history through Kyriba. To load earlier activity, upload a bank statement manually in Stuut.

## What you'll provide to Stuut

| Item | Where it comes from |
| - | - |
| **API URL** and **token URL** | Your Kyriba environment's API and OAuth token addresses. Your Kyriba admin can find them. |
| **Client ID** and **client secret** | The API client your Kyriba admin creates for Stuut, with the `process-template-scope` permission. |
| **Template codes** | The codes of the export templates that produce your bank statements. |

> [!WARNING]
>
> Treat the client secret like a password. Share it with your Stuut team only through the secure method they provide, never in a plain email.

## Setup

**1. Create an API client**

Your Kyriba admin creates an API client for Stuut that uses the client credentials flow, and grants it the **process-template-scope** permission so it can run process templates and download their files. If your company doesn't have API access yet, your admin can request API credentials from Kyriba through a support ticket on the Kyriba Developer Portal.

**2. Set up export templates**

Create (or reuse) one or more export templates that output your bank statements in BAI2, MT940, or CAMT.053 format. Include every account that receives customer payments.

**3. Share with Stuut**

Send your Stuut team the API URL, token URL, client ID, client secret, and template codes. Stuut creates the connection and runs a test sync.

**4. Review and go live**

Review the imported transactions in Cash App with your Stuut team. After that, Stuut runs your templates every hour automatically.

### Sample request to your Kyriba admin

```text theme={null}
Subject: Kyriba API Access for Stuut

Hi [Kyriba admin],

We are connecting Kyriba to Stuut to automate our cash application. Could you
please set up the following?

1. An API client for Stuut using the client credentials flow, with the
   process-template-scope permission (to run process templates and download
   their output files).
2. An export template that produces our bank statements in BAI2 (or MT940 /
   CAMT.053) format for these accounts: [List accounts]
3. Send me the API URL, token URL, client ID, client secret, and template
   code(s) so I can share them securely with Stuut.
```

## FAQ

> [accordion] Do I need to connect each bank separately?
>
> No. Stuut reads whatever statements your Kyriba templates return, so one connection can cover all the banks Kyriba already collects from.

> [accordion] Can Stuut load past transactions from Kyriba?
>
> No. Kyriba templates return current statements only. To load earlier activity, upload bank statements manually in Stuut.

> [accordion] Can I use more than one template?
>
> Yes. Share every template code you want Stuut to run, and Stuut runs each one every hour.

> [accordion] Can Stuut change anything in Kyriba?
>
> No. Stuut only runs the export templates you share and downloads their files.

## Questions?

If you have questions about your Kyriba integration or need help with setup, contact your Stuut team or [support@stuut.co](mailto:support@stuut.co).


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