Update Subscription Groups CSV page [netlify-build]

Author: pwseg

src/engage/user-subscriptions/subscription-groups.md

@@ -35,7 +35,7 @@ Follow these steps to create a subscription group:
 4. (Optional:) Add subscribers to your group with a CSV file upload, then click **Next**.
 5. Review your new subscription group, then click **Create Subscription Group**.
 
-### Add group susbcribers
+### Add group subscribers
 
 In addition to adding group subscribers when you first create a subscription group, you can also add subscribers to existing groups with a CSV file upload with these steps:
 
@@ -44,6 +44,58 @@ In addition to adding group subscribers when you first create a subscription gro
 3. Download the template CSV file, then fill it out by entering email addresses and subscription groups. The subscription group should follow the format `[group_name]_subscription_status`.
 4. Upload the CSV file, then click **Add Subscribers**.
 
+### Validation errors
+
+The following table lists validation errors you may run into with your CSV upload:
+
+| Error                                | Error Message                                                                                      |
+| ------------------------------------ | -------------------------------------------------------------------------------------------------- |
+| Invalid file types                   | You can upload only .csv files. Change your file format, then try again.                           |
+| Empty files                          | This file contains no data. Add data to your CSV, then try again.                                  |
+| CSV parsing error                    | We encountered an issue while parsing your CSV file. Validate the CSV file and try again.          |
+| Unexpected/fallback                  | Something went wrong. Try again later.                                                             |
+| Empty header row                     | This file contains empty header(s). Remove the empty header(s), then try again.                    |
+| File exceeds one million rows        | Too many rows. You can upload up to 1000000 rows.                                                  |
+| File exceeds 100 MB                  | Files can be up to 100 MB.                                                                         |
+| Extraneous columns/column name typos | This file has columns that do not match the identifiers in your identity resolution configuration. |
+
+### View update history
+
+Use the Update History page to view CSV file uploads in your workspace over the last 30 days.
+
+To view the Update History page:
+
+1. Navigate to **Unify > Profile explorer** or **Engage > Engage settings > Subscriptions**.
+2. From the **Subscription groups** table, click the three dots icon, then click **View update history**.
+3. From the **Upload history** table, click the file name link to download the [error reports](#error-reports).
+
+Engage uses the following error codes on the report:
+
+| Error code                  | Description                                                                                                                                                  |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| INVALID_EMAIL               | The email address isn't formatted correctly.                                                                                                                 |
+| INVALID_PHONE               | The phone number is invalid.                                                                                                                                 |
+| INVALID_SUBSCRIPTION_STATUS | The subscription status is invalid. Check the status or leave it blank.                                                                                      |
+| CONFIGURATION_ERROR         | Your SendGrid settings are not configured correctly. [Contact Segment support](https://app.segment.com/workspaces?contact=1){:target="_blank"} for help.     |
+| SYSTEM_ERROR                | Something went wrong. Please try again.                                                                                                                      |
+| UNABLE_TO_SUBSCRIBE         | You can't update the subscription status for this phone number because the user unsubscribed by replying `STOP`. The user must reply `START` to resubscribe. |
+| GLOBAL_STATE_NOT_SUBSCRIBED | Global state isn't subscribed or set, so Segment can't update subscription states.                                                                           |
+
+
+#### Subscription group CSV upload limits
+
+Please note the following limits as you upload CSV files to Twilio Engage:
+- You can only upload .csv files.
+- Files can't be empty and must have at least one header and one row.
+- You can't have multiple columns with the same header.
+- Upload CSV files with up to 1 million rows (plus one header row).
+- You can only upload one file at a time.
+- The CSV file size can't exceed 100 MB.
+- If you upload the same email or phone number with different subscription states in a single CSV file, Engage doesn't guarantee the subscription status result.
+- The `phone` and `email` identifiers must be valid phone numbers and email addresses, otherwise they'll process as errors.
+- The subscription group CSV uploader only honors group subscriptions, so `sms_subscription_status`, `whatsapp_subscription_status`, and `email_subscription_status` aren't allowed.
+- Other than `[group_name]_subscription_status`, you should set up all columns in your identity resolution configuration.
+
 ### Create a new email template and send an email
 
 > info ""