Sync external accounts through a vendor, such as Plaid.

Sync external accounts for a customer through an existing access token. The token must be valid, and the information on the accounts returned by the vendor must correspond to the customer. A success response for this route may include failures if an account could not be added and deletions if the account is removed by the end user, so it’s important that the caller checks the response body.

Authorizations

Authorization · string · header · required

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

Headers

Idempotency-Key · string

An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Body

application/json

customer_type · enum<string> · required

The type of customer in the external financial institution. Not necessarily the customer type on Synctera's platform: a business customer might link to the owner's personal account at an external financial institution.

Available options:

BUSINESS,

PERSONAL

vendor · enum<string> · required

The vendor selected for the operation.

Available options:

FINICITY,

PLAID

business_id · string<uuid>

The identifier for the business customer associated with this external account. Exactly one of business_id or customer_id must be specified.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

customer_id · string<uuid>

The identifier for the personal customer associated with this external account. Exactly one of customer_id or business_id must be specified.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

vendor_access_token · string

The token provided to link external accounts. For Plaid, this is their access_token.

Minimum length: 1

Example:

"access-sandbox-de3ce8ef-33f8-452c-a685-8671031fc0f6"

vendor_account_ids · string[]

The list of vendor account IDs that the customer chose to link. For Plaid, these are account_ids.

Minimum length: 1

The Plaid account_id.

vendor_customer_id · string

The identifier provided by the vendor for the customer associated with this external account.

Example:

123

verify_owner · boolean · default: false

If true, Synctera will attempt to verify that the external account owner is the same as the customer by comparing external account data to customer data. At least 2 of the following fields must match: name, phone number, email, address. Verification is disabled by default.

Response

200

application/json

Result of syncing accounts through the vendor.

added_accounts · External account · object[] · required

Show child attributes

failed_accounts · object[] · required

Show child attributes

deleted_accounts · External account · object[]

Show child attributes