Skip to main content
When a customer no longer needs a connection — they revoked access, switched banks, or the connection is a duplicate — you can delete it. This page is for developers cleaning up connections so they no longer receive webhooks or incur billing.

​
Before you begin

  • You have the connectionId you want to delete
  • You understand deletion is permanent — a deleted connection cannot be recovered
  • For duplicate connections, remember to delete all duplicates if you want to fully sever the underlying provider link

​
How to delete a connection

Call the delete connections endpoint with the connectionId. Once you delete a connection:
  • It is deleted on both Meld and the underlying service provider.
  • You will no longer receive any updates (webhooks) for it.
  • You will no longer be billed for it.
  • A BANK_LINKING_CONNECTION_DELETED webhook is sent to confirm.
You can only delete a connection, not individual financial accounts under a connection. To stop tracking a subset of a customer’s accounts, the customer must reconnect and choose which accounts to share.
For the full request and response schema, refer to the Bank Linking API reference.

​
Common errors

HTTP statusLikely causeDeveloper action
404 Not FoundInvalid connectionIdVerify the id and the environment (sandbox vs production).
409 ConflictConnection is already DELETEDNo action needed — confirm with a GET on the connection.
5xxTransient provider or Meld issueRetry with backoff. The Meld side may succeed even if the provider call retries; the webhook is the source of truth.