Connected account email configuration

You can customize the emails that Stripe sends to your connected accounts and bulk-update their email addresses in your Connect emails settings.

The emails settings page includes sections for different categories of emails, such as Stripe compliance emails, 1099 tax reporting emails, and tax document emails. Each section displays the number of each type of connected account that those emails apply to, for example: “Applies to 12 connected accounts who use the Express Dashboard.” You can open the Connected accounts page in a new tab, filtered to show the associated connected accounts, by clicking one of the numbers.

Customize emails

You can customize the following elements of Stripe emails to your connected accounts:

• Appearance and branding
• The domain of the From address (the specific address depends on the context of the email)
• URLs of the pages hosting your Connect embedded components

1. In the section for the email type that you want to update, click Preview and customize.
2. To customize email branding, click Customize branding to open the Branding panel. Configure the panel settings, then click Save.
3. To have the From address use a custom domain, click Customize domain to open the Customer emails tab of your Business settings page in a new browser tab.
4. To customize the URLs that host your Connect embedded components, click Manage URLs to open your Site links settings page in a new browser tab.
5. To preview a specific email with the updated settings, select an email type from the Choose email to view dropdown.
6. To send the preview email as a test, click Send email and enter the recipient address.
7. When you’re finished, click Done.

Manage recipients

You can export, update, and import the recipient addresses for an email type, subject to the following restrictions:

• You must have the Administrator or Super Administrator user role.
• You must be in live mode. Attempting to export the address list in test mode or a sandbox results in an error.
• You can update a maximum of 100,000 email addresses at a time. If you need to update more than that, split the update into multiple files or use the API.

1. In the section you want to update, click Manage recipients to open the Update email addresses dialog.
2. Download a CSV file of the current recipients by clicking Emails.csv.
3. Edit the downloaded file with the updated email addresses.
4. Upload the updated file by clicking Upload CSV or dragging and dropping the file.
5. Verify the update by checking the data preview, then click Confirm.

The CSV file looks like this example:

Account ID,Business Name,First Name,Last Name,Email Address (please add or replace),User has claimed primary user email address
acct_123abc,Connected Account A,John,Doe,,✔
acct_123abc,Connected Account A,John,Doe,john.doe@example.com,✔
acct_456def,Connected Account B,Test,Smith,test@example.com,✗
acct_789ghi,Connected Account C,,,owner@example.com,✗
acct_012jkl,Connected Account D,,,,✗

Importing the CSV file only updates the email addresses. You can’t use it to edit any of the other properties.