Overview
Torii integrates with Payhawk and syncs users, licenses, and analyzes SaaS expenses:
| Default synced transaction types | Fields used for expense matching |
|---|---|
| Card transactions | Supplier name |
| Bank transfers (bill payments) | Title |
| Reimbursements | Category |
| Note |
- Torii will automatically match transactions to the correct application, summarize expenses and provide insights.
- Torii syncs transaction data up to one year prior to first connection date.
- You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
Requirements
To connect this integration, we require the following:
Accounts & Permissions
- A Payhawk account.
- The user generating credentials must hold one of: Payhawk Administrator, Payhawk IT Administrator, or a custom role with both View developer API access and Manage external integrations permissions.
Required keys
- Account ID — the unique identifier of the Payhawk account.
- API Key — generated for that account.
- Account Name (Optional) — a friendly label shown in Torii.
How to Generate the Required Values
Step 1: Locate your Account ID
- Sign in to the Payhawk Web Portal.
- Look at the URL — it contains
?account={accountId}. Copy the value.
Step 2: Create an API key
- Go to Settings → Integrations → Available integrations.
- Find the API connection and click Connect.
- Fill in the requested details and click Create.
- Copy the generated API key. It can be re-copied or regenerated from the same screen later.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for Payhawk and click Connect.
- Enter your Account ID, API Key, and (optionally) Account Name.
- Click Connect.
Actions
-
Invite Payhawk user — sends a Payhawk invite email with the role you provide. Roles must match what your Payhawk account has configured (e.g.
employee,administrator, plus any custom roles). - Update Payhawk user — updates only the user's role. Name and email cannot be changed via the API.
- Remove Payhawk user — permanently removes the user from your Payhawk account.
Q&A
Q: Why are my Payhawk users always shown as Active in Torii?
A: Payhawk's public API doesn't return a status flag on users — only currently-active members appear in the user list. When a user is removed in Payhawk they disappear from the API response, and Torii's standard stale-record handling marks them as deleted on the next sync.
Q: Can I change a user's name or email with the Update Payhawk user action?
A: No. Payhawk's API only allows the role to be updated. Name and email changes must be made directly in the Payhawk app.
Q: Does Remove Payhawk user deactivate or delete?
A: It permanently deletes. Payhawk has no separate deactivate endpoint.
For any further questions, please contact Torii Support.