SimpleFIN

Create new SimpleFIN connection

Creates a SimpleFIN destination and returns a one-time setup token. Paste the token into the consumer app's "Link bank account with SimpleFIN" flow; it exchanges the token for pull credentials and then syncs the exposed accounts on demand. app selects which app this connection is presented as (Actual Budget by default); it does not change behavior.

POST

/destinations/simplefin/connections

curl --request POST \
  --url https://api.synci.io/api/v1/destinations/simplefin/connections \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "accounts": [
      {
        "financial_account_id": "<string>",
        "first_pulled_at": "<string>",
        "id": "<string>",
        "last_pulled_at": "<string>",
        "name": "<string>",
        "still_shared": "<string>"
      }
    ],
    "all_accounts": true,
    "app": "<string>",
    "claimed_at": "<string>",
    "created_at": "<string>",
    "enabled": "<string>",
    "financial_accounts": [
      "<string>"
    ],
    "health": {
      "failure_count": "<string>",
      "integrator_message": "<string>",
      "last_attempt_at": "<string>",
      "status": "<string>",
      "transient_failure_count": "<string>",
      "transient_message": "<string>"
    },
    "id": "<string>",
    "last_pulled_at": "<string>",
    "name": "<string>",
    "revoked_at": "<string>",
    "setup_token": "<string>",
    "setup_token_expires_at": "<string>",
    "status": "<string>",
    "updated_at": "<string>"
  },
  "message": "SimpleFIN connection created."
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

all_accountsboolean

Expose every financial account the user owns, including ones connected in the future. When true, financial_accounts is ignored.

appenum<string> | null

Which SimpleFIN app this connection is for (drives the card, icon, and setup guide; no effect on protocol behavior).

Available options: actual_budget, other

enabledboolean

Whether the connection is enabled. Disabled connections reject pulls.

financial_accountsinteger[] | null

IDs of the financial accounts to expose.

namestring | null

Display name for the connection.

Maximum string length: 255

Response

dataobjectrequired

Show child attributes

messagestringrequired

Still need help? Ask the team