Create a connect or reconnect link

Returns a hosted Financy page (linkSession.url) to open for the user, where they sign in to Financy and type the system's credentials themselves; the credentials never go through the API. The link expires after 10 minutes and must be opened by the same Financy user the token names. connect adds an integration of connectorId; reconnect replaces the credential of an existing integrationId (not available for Isracard Business yet: 501 NOT_IMPLEMENTED). At most 10 links per user per hour. Approving drafts is not a purpose an API key can use (403 APPROVAL_SURFACE_NOT_ALLOWED). Business systems are connected only through the hosted Financy page (POST /integrations/link-sessions): credentials never pass through the API. Invoicing systems (Invoice4U, Morning, SUMIT, iCount) are included from Starter; Priority (ERP) and Isracard Business (card clearing) need Pro. Each plan allows a number of integrations per system per organization: 1 on Starter, 5 on Pro, 20 on Ultra.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
required
Allowed:
string
enum
required
Allowed:
string
^\/(?!\/)[A-Za-z0-9/_-]{0,199}$

A path on Financy web to return the user to afterwards.

Responses

401

Missing or invalid access token (answered by the API gateway, without the error envelope).

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json