MagicDoorAPI
SupportOpen MagicDoor
Bank feeds

Remove a bank feed connection

Disconnects a bank feed. No more transactions are pulled from that bank. Requires the reconciliations:write permission.

DELETE
https://services.magicdoor.com/accounting/company-portal/bank-feeds/connections/{connectionId}

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

connectionIdstringrequired

Snowflake id of the bank feed connection.

example: 1830472847398408100

Response

200 · The connection as it now stands, with `status` set to `Disconnected`.

idstring

Snowflake id of the bank feed connection.

companyIdstring

The company that owns the connection.

providerConnectionIdstring

The provider's own identifier for the linked institution. An opaque token — do not parse it. An empty string when the provider has not supplied one.

statusstring

Active while the feed is working, RequiresReauth when the bank needs the user to sign in again, Disconnected once the link has been removed. The value is written exactly as it appears here, in PascalCase — these particular status fields are plain strings rather than the camelCase enums used elsewhere in the API.

ActiveRequiresReauthDisconnected
lastSyncedstring · date-time

When transactions were last pulled from the bank, in the company's timezone. Absent until the first sync finishes.

lastRefreshRequestedstring · date-time

When a manual refresh was last asked for, in the company's timezone. Absent until one is.

accountsAccount[]

The bank accounts this connection feeds.

createdstring · date-time

When the connection was made, in the company's timezone.

updatedstring · date-time

When the connection last changed, in the company's timezone.

401 · The access token is missing, expired, or not for this company.

403 · The caller does not hold the `reconciliations:write` permission.

404 · No bank feed connection with this id belongs to the caller's company.

Relinking means going through the widget again

There is no endpoint that reconnects a removed connection. To get the feed back, start over at Create a link token.