Apideck CLI: Query 200+ SaaS APIs from your terminal. No SDK needed. Read more

Apideck Documentation Page

How to configure the Intuit Enterprise Suite Disconnect URL

Apideck enables you to detect when a customer disconnects your app directly from Intuit Enterprise Suite (IES) — for example, via My Apps → Disconnect — rather than only when they disconnect through your product. This guide explains how to configure the Disconnect URL in your Intuit Developer app so Apideck can receive provider-initiated disconnect notifications and fire the vault.connection.revoked webhook event.

Before you start, you'll need:

Why configure a Disconnect URL

Without a Disconnect URL, Apideck only learns that a connection is no longer valid the next time it tries to use the token — which can be hours or days after the user actually disconnected. Configuring the Disconnect URL closes this gap by letting Intuit notify Apideck the moment a user revokes access on their side. Apideck then marks the connection as revoked and emits the vault.connection.revoked webhook event so your app can react immediately (clear cached data, prompt the user to reconnect, stop scheduled syncs, etc.).

Configure the Disconnect URL

1. Copy the Disconnect URL from Apideck

  1. Sign in to the Apideck Dashboard.
  2. Navigate to Configuration → Accounting → Intuit Enterprise Suite.
  3. Locate the Disconnect URL field and copy the value.

2. Paste the Disconnect URL into your Intuit app

  1. Sign in to the Intuit Developer dashboard.
  2. Select your app, then open Add Detail → Settings → App URLs.
  3. Paste the URL from step 1 into the Disconnect URL field.
  4. Save your changes.

3. Verify with a sandbox disconnect

  1. Connect an Intuit Enterprise Suite sandbox company through Vault.

  2. In Intuit Enterprise Suite, go to My Apps → Disconnect and disconnect your app.

  3. Confirm that Apideck has registered the disconnect by calling the Get Connection endpoint:

    curl --location --request GET 'https://unify.apideck.com/vault/connections/accounting/intuit-enterprise-suite' \
--header 'x-apideck-consumer-id: {CONSUMER_ID}' \
--header 'x-apideck-app-id: {APIDECK_APP_ID}' \
--header 'Authorization: Bearer {APIDECK_API_KEY}'

    In the response, confirm health is "revoked". This is the signal that Apideck received the provider-initiated disconnect notification from Intuit.

  4. Confirm your webhook endpoint received a vault.connection.revoked event.

Each IES entity is a separate company/realm with its own connection, so a disconnect revokes only the entity the user disconnected — any other entities the same consumer authorized stay connected.

Optional: configure a Disconnect Landing Page (branded redirect)

By default, after a user disconnects from within Intuit Enterprise Suite, Apideck shows a generic confirmation page telling them the integration was disconnected successfully.

If you'd like users to instead be redirected to a branded page you control — for example, a "You've disconnected Intuit Enterprise Suite" screen with a reconnect button — configure a Disconnect Landing Page in Apideck.

  1. In the Apideck Dashboard, go to Configuration → Redirects.
  2. Set the Disconnect Landing Page to the URL you want users redirected to after they disconnect. It must be an https:// URL — Apideck falls back to its own confirmation page for anything else.
  3. Save your changes.

Apideck appends status=disconnected and serviceId=intuit-enterprise-suite to that URL when it redirects, so your page can tell the user which integration was disconnected.

Disconnect URL vs. Disconnect Landing Page

SettingConfigured inPurpose
Disconnect URLIntuit Developer (your app)Where Intuit sends the user's browser when they disconnect in IES. Intuit redirects to this URL with the company's realmId in the query string, which is how Apideck identifies the connection to revoke. Triggers vault.connection.revoked.
Disconnect Landing PageApideck (Configuration → Redirects)The branded page your user is redirected to in their browser after disconnecting.

Handling the vault.connection.revoked event

Once the Disconnect URL is configured, your webhook endpoint will receive a vault.connection.revoked event whenever an Intuit Enterprise Suite user disconnects on Intuit's side. Recommended actions in your application:

  • Mark the connection as revoked in your own database.
  • Stop any scheduled syncs or background jobs that depend on the token.
  • Clear or invalidate any cached data tied to the connection.
  • Surface a "Reconnect Intuit Enterprise Suite" prompt the next time the user is active.

For the full event payload and webhook subscription setup, see the Vault Webhook Events Guide.

Troubleshooting

Apideck isn't receiving disconnect notifications. After disconnecting in Intuit Enterprise Suite, call Get Connection and check the health field. If it's still "ok" a few minutes later, Intuit isn't reaching Apideck. Double-check that the Disconnect URL pasted into Intuit exactly matches the value shown in the Apideck Dashboard — no trailing slashes, no extra whitespace, and the path must end in intuit-enterprise-suite rather than another connector's id. Save the Intuit app after pasting; unsaved changes are a common cause.

vault.connection.revoked isn't firing on my endpoint. Confirm your webhook subscription includes the vault.connection.revoked event type and that your endpoint is reachable from the public internet. Check the webhook delivery log in the Apideck Dashboard for failed attempts.

Users land on Apideck's generic confirmation page after disconnecting, not my branded page. This means the Disconnect Landing Page isn't set in Apideck. See the optional step above — this is a separate setting from the Intuit-side Disconnect URL.

I can't find the Disconnect URL field in my Intuit app. The field is under Add Detail → Settings → App URLs, not under Keys & OAuth. If you're looking at a newly created app, you may need to complete initial app setup (name, category, redirect URI) before the App URLs section is fully editable.

Next steps