Skip to main content
POST
Add external accounts through a vendor, such as Plaid.

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 string 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 array length: 1

The Plaid account_id.

Minimum string length: 1
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

Result of adding accounts through the vendor.

added_accounts
External account · object[]
required
failed_accounts
object[]
required
deleted_accounts
External account · object[]