# Configure auto-respond settings for Smart Disputes

Automate evidence submission for your account and connected accounts.

Smart Disputes can automatically submit evidence for available disputes before the dispute deadline. This guide explains how to configure the auto-respond settings for your account type.

When auto-respond is enabled:

- You don’t miss dispute deadlines.
- We automatically submit evidence for available disputes.
- You spend less time manually managing disputes.

Smart Disputes determines eligibility based on dispute characteristics and available evidence. Not all disputes qualify for automatic submission.

You can manually submit evidence at any time, even with auto-respond enabled.

## Configure auto-respond 

1. Go to **Settings** > [Disputes](https://dashboard.stripe.com/settings/disputes) in the Dashboard.
1. Enable **Smart Disputes**.

Changes apply immediately to disputes that still require a response. When you disable auto-respond, you accept and lose any dispute that you don’t respond to by the deadline.

## Settings for Connect platforms 

As a platform, you control Smart Disputes auto-respond settings for your connected accounts. You can set a default for all connected accounts and choose whether they can override your default.

These settings apply to payments your connected accounts create using direct charges and destination charges (including destination on_behalf_of). To configure auto-respond for your disputes, see [Configure auto-respond](https://docs.stripe.com/disputes/smart-disputes/auto-respond.md#configure-auto-respond).

#### Dashboard

On the Connect [Disputes settings](https://dashboard.stripe.com/settings/connect/disputes) page, configure your preferences:

- **Turn auto-respond on or off for connected accounts**: Set the default for all connected accounts.
- **Allow connected accounts to override**: Allow connected accounts to change their own settings.

Changes apply immediately to disputes that still require a response.

### Default and override settings 

Smart Disputes have the following default and override settings:

- **Platform default**: All connected accounts inherit your platform setting unless you set an explicit override using the API, or you allow them to override it.
- **API overrides**: You can set individual account preferences using the Accounts API.
- **Connected account overrides**: If you allow overrides, connected accounts can change their own settings.

When you change your platform default, connected accounts with `preference`=`inherit` (or no explicit API override) immediately reflect your new default. Accounts with explicit overrides aren’t affected.

#### API

For more control over individual connected accounts, use the Accounts API to set the `smart_disputes` hash.

After you set an explicit `preference`, the account ignores platform-level default changes until you reset it to `inherit`.

| Field                   | Description                        | Values                                                                                                                                                                              |
| ----------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `preference` (writable) | Controls the intended behavior     | - `on`: Enable auto-respond, and override the platform default
  - `off`: Disable auto-respond, and override the platform default
  - `inherit`: Use the platform’s default setting |
| `value` (read-only)     | Shows the actual effective setting | - `on`: Auto-respond is currently enabled
  - `off`: Auto-respond is currently disabled                                                                                             |

Example API call:

```curl
curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-02-25.preview" \
  -d "settings[smart_disputes][auto_respond][preference]=on"
```

## Settings for connected accounts 

On the [Disputes settings](https://dashboard.stripe.com/settings/connect/disputes) page in the Dashboard, you see auto-respond settings for Smart Disputes:

- **Your own disputes**: Disputes on payments made directly on your account (not associated with any platform).
- **Each platform you’re connected to**: Disputes on payments created through each platform.

If you can’t toggle the auto-respond setting, your platform has disabled overrides. You must contact your platform to change your auto-respond settings.