Reconfirm the consent of a financial connection

When reconfirming consent, Synci will generate an authorization URL (auth_url). You should follow the authorization URL to activate the connection. Once the connection is authorized, Synci automatically fetches the available financial accounts. On an end user's own connection, a first balance and transaction sync then starts as soon as each account is discovered, which is before anything could have configured it: that first sync's depth therefore comes from this connection's max_historical_days (any value up to the institution's maximum is accepted here), not from an account's config.sync_start_date.

Platform partners. Accounts discovered on your connections are created with sync_auto off and nothing is fetched until you ask, because you configure each account after it appears. Send your account config (sync_start_date plus sync_auto: true), or call POST /finance/accounts/{id}/sync, and the first sync runs on your terms. Note that sync_start_date is the depth the backfill works toward rather than a filter on what you receive, so set it to the oldest date you want: history before it is never fetched.

Managed apps. Renewals for your users happen in the connection portal, not through this endpoint: called with a managed user's access token it answers 403 with code: "managed_connection_requires_portal". Mint a portal session (POST /managed/v1/users/{userId}/portal-sessions) with connection_id instead. The portal shows a short interlude and then starts the renewal of that connection by itself, and returns the user to your return_url with connection and status query parameters. Renewing keeps the connection id, its accounts and their history, and a connection.reauthorized webhook follows.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://api.synci.io/oauth/authorize

Token URL: https://api.synci.io/oauth/token

Path Params

Body Params application/json

Examples

curl --location --request PUT 'https://api.synci.io/api/v1/finance/connections//reauthorize' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "max_historical_days": 0, "access_valid_for_days": 1, "sync_balances": true, "integrator": "UNKNOWN" }'

Reconfirm the consent of a financial connection

Request

Responses