Skip to main content

Create New Connections


AnchorOverview

In general, the connection process with Quiltt for Plaid follows these steps:

  1. Call the connector[IntegrationName]Initialize mutation to initialize a connection widget for the integration (arguments for this mutation determine the configuration and mode for Link).
  2. Open the connection with the data provided by the connector[IntegrationName]Initialize mutation.
  3. After the user successfully completes the connection flow, call the connector[IntegrationName]Close mutation to close create and sync the connection.

Each integration typically requires a specific set of fields to create a connection. See the sections for corresponding integration’s documentation:

Note: More connection integrations will become available in the future. If you are interested in integration that’s not generally available, please contact us here.


AnchorPlaid

Plaid is a leading financial data company that helps companies securely access customer-provisioned financial data.

Quiltt’s plug-and-play Plaid integration makes ingesting, enriching and using Plaid data easier and more accessible.

The connectorPlaidInitialize mutation is used to create a Link Token to configure an instance of Link. The linkToken generated by this mutation will be used for Plaid Link initialization. Check out our guides on configuring Plaid Link with React or see Plaid’s Docs for more information.

mutation ConnectorPlaidInitialize($input: ConnectorPlaidInitializeInput) {
connectorPlaidInitialize(input: $input) {
success
record {
connectorStatus
connectorToken
expiration
linkToken
requestId
}
errors {
code
message
}
}
}

AnchorConnectorPlaidInitializeInput

Autogenerated input type of ConnectorPlaidInitialize

FieldTypeDescription
accountFiltersPlaidLinkTokenAccountFiltersBy default, Link will provide limited account filtering: it will only display Institutions that are compatible with all products supplied in the products parameter of /link/token/create, and, if auth is specified in the products array, will also filter out accounts other than checking and savings accounts on the Account Select pane. You can further limit the accounts shown in Link by using account_filters to specify the account subtypes to be shown in Link. Only the specified subtypes will be shown. This filtering applies to both the Account Select view (if enabled) and the Institution Select view. Institutions that do not support the selected subtypes will be omitted from Link. To indicate that all subtypes should be shown, use the value “all”. If the account_filters filter is used, any account type for which a filter is not specified will be entirely omitted from Link. For a full list of valid types and subtypes, see the Account schema.
androidPackageNameStringThe name of your app’s Android package. Required if using the link_token to initialize Link on Android. When creating a link_token for initializing Link on other platforms, this field must be left blank. Any package name specified here must also be added to the Allowed Android package names setting on the developer dashboard.
authPlaidLinkTokenCreateRequestAuthSpecifies options for initializing Link for use with the Auth product. This field is currently only required if using the Flexible Auth product (currently in closed beta).
clientMutationIdStringA unique identifier for the client performing the mutation.
clientNameStringThe name of your application, as it should be displayed in Link. Maximum length of 30 characters. If a value longer than 30 characters is provided, Link will display “This Application” instead. Defaults to your Quiltt deployment’s branding.
connectionIdIDUsed when launching Link in update mode, when completing the Same-day (manual) Micro-deposit flow, or (optionally) when initializing Link as part of the Payment Initiation (UK and Europe) flow.
countryCodes[String!]An array of Plaid-supported country codes using ISO-3166-1 alpha-2 country code standard
euConfigPlaidLinkTokenEUConfigConfiguration parameters for EU flows
featuresConnectionFeature!
languageStringThe language that Link should be displayed in. Supported languages are: English (“en”) French (“fr”) Spanish (“es”) Dutch (“nl”) German(“de”). When using a Link customization, the language configured here must match the setting in the customization, or the customization will not be applied.
linkCustomizationNameStringThe name of the Link customization from the Plaid Dashboard to be applied to Link
products[String!]List of products to use with Link
updatePlaidLinkTokenCreateRequestUpdateSpecifies options for initializing Link for update mode.

View static documentation on the GraphQL Explorer on your Dashboard for a complete list of typings.

AnchorConnectorPlaidInitializePayload

Autogenerated return type of ConnectorPlaidInitialize

FieldTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
errors[PlaidAPIError!]Plaid API Error
recordPlaidConnector
successBoolean!Status of the mutation

View static documentation on the GraphQL Explorer on your Dashboard for a complete list of typings.

AnchorCreate a Connection

After your user successfully completes the Plaid Link session, call the connectorPlaidClose mutation from Plaid Link’s onSuccess callback, passing in the Quiltt connectorToken, along with Plaid Link’s metadata and publicToken.

mutation ConnectorPlaidClose($input: ConnectorPlaidCloseInput) {
connectorPlaidClose(input: $input) {
success
record {
id
accounts {
id
name
}
institution {
name
logo
}
}
errors {
code
message
}
}
}

AnchorConnectorPlaidCloseInput

Autogenerated input type of connectorPlaidClose

FieldTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
connectorTokenString!The connector_token string from Connector Initialization
metadataJSON!The metadata object from Plaid Link’s onSuccess callback
publicTokenString!The public_token string from Plaid Link’s onSuccess callback

View static documentation on the GraphQL Explorer on your Dashboard for a complete list of typings.

AnchorConnectorPlaidClosePayload

Autogenerated return type of connectorPlaidClose

FieldTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
errors[PlaidAPIError!]Plaid API Error
recordConnectionTypeConnection
successBoolean!Status of the mutation

View static documentation on the GraphQL Explorer on your Dashboard for a complete list of typings.