Skip to main content
POST
Create transaction

Authorizations

Authorization
string
header
required

Organization API key created in Grain Settings → API. The key determines the organization and is limited to its assigned resource scopes. Write scopes imply the corresponding read scope.

Headers

X-Organization-Id
string

Required with OAuth access tokens for resource requests. Omit only for GET /api/v1/organizations. Optional with organization API keys; if supplied with an API key, it must match the key's organization.

Idempotency-Key
string

Stable key for one transaction create, retained for the lifetime of the organization. Keys are scoped to organization and credential.

Required string length: 1 - 200
Pattern: ^[!-~]+$

Body

application/json
description
string
required
Minimum string length: 1
Example:

"Weekly offering deposit"

amount
number
required
Required range: x >= 0
Example:

4250

date
string<date>
required
Example:

"2026-07-01"

transactionType
enum<string>
required

DEPOSIT records an inflow; the other types record an outflow.

Available options:
DEPOSIT,
WITHDRAWAL,
TRANSFER,
ADJUSTMENT
Example:

"DEPOSIT"

referenceNumber
string
Example:

"DEP-2026-0701"

bankAccountId
string

Connected bank or card feed account.

accountId
string

Ledger cash or bank account for manual transactions.

fundId
string
vendorId
string
is1099Excluded
boolean
externalId
string

Your system's ID for this transaction. Unique within the organization; a duplicate returns 409. Cannot be changed later.

Required string length: 1 - 255
foreignCurrency
string
foreignAmount
number
exchangeRate
number

Response

Created transaction

id
string
required
externalId
string | null
required

Integrator-supplied ID, unique within the organization.

description
string
required
amount
number
required

Always positive. Use direction for the sign.

Required range: x >= 0
direction
enum<string>
required
Available options:
INFLOW,
OUTFLOW
transactionType
enum<string>
required
Available options:
DEPOSIT,
WITHDRAWAL,
TRANSFER,
ADJUSTMENT
date
string<date-time>
required

Calendar day represented as a UTC-midnight ISO timestamp.

referenceNumber
string | null
required
source
enum<string>
required
Available options:
MANUAL,
PLAID,
IMPORT,
PLANNING_CENTER,
PUSHPAY,
TITHELY,
SUBSPLASH,
ROCK_RMS,
RAMP,
DIVVY,
OVERFLOW
reviewStatus
enum<string>
required
Available options:
DRAFT,
PENDING_REVIEW,
PENDING_TRANSFER_MATCH,
PENDING_TRANSFER_CONFIRM,
AUTO_CATEGORIZED,
APPROVED,
POSTED,
REJECTED
isReconciled
boolean
required
is1099Excluded
boolean
required
bankAccount
object | null
required

Connected bank or card feed, when the transaction came from one.

sourceAccount
object | null
required

Ledger cash, bank, or card account the transaction clears through.

fund
object | null
required
vendor
object | null
required
dimensions
object[]
required

Header dimensions for the transaction.

coding
object
required
suggestion
object | null
required

Rule or AI coding suggestion awaiting review.

attachmentCount
integer
required
Required range: x >= 0
canManage
boolean
required

Whether this credential can edit the transaction.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
Last modified on October 10, 2026