SaaSFlow
DevelopersAPIReferencetransactions

Unlink transfer

Break a transfer link. How much comes apart depends on link: path dissolves the whole transfer and removes the transit bookings SaaSFlow created, counter…

Authentication

Checking whether you're signed in…
POST
/companies/{companyId}/transactions/unlink_transfer

Authorization

headerAuthorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

Path Parameters

companyId*string
Length1 <= length

Request Body

application/json
  1. body
transactionId*string
Length1 <= length
categorizationId*string
Length1 <= length
link?string

How much of a transit-routed transfer to unlink: "path" dissolves the whole transfer — both account transactions are unlinked and the auto-created transit bookings are removed; "counter" (default) unlinks only this transaction from its transit booking; "transit" reopens a closed path by unlinking only the two transit positions. For directly linked (non-transit) transfers the value is ignored.

Default"counter"
Value in"counter""path""transit"

Response Body

Transfer unlinked

application/json
  1. response
success*boolean
curl -X POST "https://example.com/companies/string/transactions/unlink_transfer" \  -H "Content-Type: application/json" \  -d '{    "transactionId": "string",    "categorizationId": "string"  }'
{  "success": true}

Import

Bulk-import transactions, which is the endpoint behind CSV upload and any backfill of history. Amounts follow the same convention as single creation…

Create counter transaction

Book the missing other half of a transfer. When money left one account and the matching arrival was never imported, for example on a cash or wallet account…