Deploy - December 13, 2022

_docs/_api/api_limits.md

@@ -85,12 +85,12 @@ If you have questions about API limits, contact your customer success manager or
 ### Optimal delay between endpoints
 
 {% alert note %}
-We recommend that you allow for a 5-minute delay between consecutive endpoint calls to minimize errors.
+We recommend that you allow for a 5-minute delay between consecutive endpoint calls to multiple endpoints to minimize errors.
 {% endalert %}
 
 Understanding the optimal delay between endpoints is crucial when making consecutive calls to the Braze API. Problems arise when endpoints depend on the successful processing of other endpoints, and if called too soon, could raise errors. For example, if you're assigning users an alias via our `/user/alias/new` endpoint, and then hitting that alias to send a custom event via our `/users/track` endpoint, how long should you wait?
 
-Under normal conditions, the time for our data eventual consistency to occur is 10–100ms (1/10 of a second). However, there can be some cases where it takes longer for that consistency to occur. Therefore, we recommend that you allow for a 5-minute delay between making subsequent calls to minimize the probability of error.
+Under normal conditions, the time for our data eventual consistency to occur is 10–100ms (1/10 of a second). However, there can be some cases where it takes longer for that consistency to occur. Therefore, we recommend that you allow for a 5-minute delay between making subsequent calls to multiple endpoints to minimize the probability of error. This recommendation does not apply to consecutive endpoint calls to the same endpoint.
 
 [1]: {{site.baseurl}}/api/endpoints/messaging/
 [2]: {{site.baseurl}}/api/objects_filters/connected_audience/

_docs/_api/endpoints/catalogs/catalog_items/asynchronous/delete_catalog_items_bulk.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the Delete Multiple Catalog It
 
 Use this endpoint to delete multiple items in your catalog. Each request can support up to 50 items. This endpoint is asynchronous.
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 100 requests per minute between all asynchronous catalog item endpoints.

_docs/_api/endpoints/catalogs/catalog_items/asynchronous/patch_catalog_items_bulk.md

@@ -18,12 +18,6 @@ description: "This article outlines details about the Edit Multiple Catalog Item
 
 Use this endpoint to edit multiple items in your catalog. Each request can support up to 50 items. This endpoint is asynchronous.
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 100 requests per minute between all asynchronous catalog item endpoints.

_docs/_api/endpoints/catalogs/catalog_items/asynchronous/post_create_catalog_items_bulk.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the Create Multiple Catalog It
 
 Use this endpoint to create multiple items in your catalog. Each request can support up to 50 items. This endpoint is asynchronous.
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 100 requests per minute between all asynchronous catalog item endpoints.

_docs/_api/endpoints/catalogs/catalog_items/synchronous/delete_catalog_item.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the Delete Catalog Item Braze
 
 Use this endpoint to delete an item in your catalog. 
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 50 requests per minute between all synchronous catalog item endpoints.

_docs/_api/endpoints/catalogs/catalog_items/synchronous/get_catalog_item_details.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the List Catalog Item Details
 
 Use this endpoint to return a catalog item and its content.
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 50 requests per minute between all synchronous catalog item endpoints.

_docs/_api/endpoints/catalogs/catalog_items/synchronous/get_catalog_items_details_bulk.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the List Multiple Catalog Item
 
 Use this endpoint to return multiple catalog items and their content.
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 50 requests per minute between all synchronous catalog item endpoints.

_docs/_api/endpoints/catalogs/catalog_items/synchronous/patch_catalog_item.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the Edit Catalog Item Braze en
 
 Use this endpoint to edit an item in your catalog. 
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate Limit
 
 This endpoint has a shared rate limit of 50 requests per minute between all synchronous catalog item endpoints.

_docs/_api/endpoints/catalogs/catalog_items/synchronous/post_create_catalog_item.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the Create Catalog Item Braze
 
 Use this endpoint to create an item in your catalog.
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 50 requests per minute between all synchronous catalog item endpoints.

_docs/_api/endpoints/catalogs/catalog_management/synchronous/delete_catalog.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the Delete Catalog Braze endpo
 
 Use this endpoint to delete a catalog.
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 5 requests per minute between all synchronous catalog endpoints.

_docs/_api/endpoints/catalogs/catalog_management/synchronous/get_list_catalogs.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the List Catalogs Braze endpoi
 
 Use this endpoint to return a list of catalogs in an app group.
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 5 requests per minute between all synchronous catalog endpoints.

_docs/_api/endpoints/catalogs/catalog_management/synchronous/post_create_catalog.md

@@ -17,12 +17,6 @@ description: "This article outlines details about the Create Catalog Braze endpo
 
 Use this endpoint to create a catalog.
 
-{% alert important %}
-Support for this endpoint is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
-{% endalert %}
-
-If you'd like to share your feedback on this endpoint or make a request, contact the Braze Catalogs team at [catalogs-product@braze.com](mailto:catalogs-product@braze.com)
-
 ## Rate limit
 
 This endpoint has a shared rate limit of 5 requests per minute between all synchronous catalog endpoints.

_docs/_api/endpoints/preference_center/get_view_details_preference_center.md

@@ -38,10 +38,11 @@ curl --location -g --request GET https://rest.iad-01.braze.com/preference_center
   "preference_center_api_id": "preference_center_api_id",
   "created_at": "example_time_created",
   "updated_at": "example_time_updated",
+  "preference_center_title": "Example preference center title",
   "preference_center_page_html": "HTML for preference center here",
   "confirmation_page_html": "HTML for confirmation page here",
   "redirect_page_html": null
 }
 ```
 
-{% endapi %}
+{% endapi %}

_docs/_api/endpoints/preference_center/post_create_preference_center.md

@@ -34,6 +34,7 @@ Authorization: Bearer YOUR-REST-API-KEY
 ```json
 {
   "name": "string",
+  "preference_center_title": "string",
   "preference_center_page_html": "string",
   "confirmation_page_html": "string"
 }
@@ -44,6 +45,7 @@ Authorization: Bearer YOUR-REST-API-KEY
 | Parameter | Required | Data Type | Description |
 | --------- | ---------| --------- | ----------- |
 |`name`| Required | String | The name of the preference center that meets the following requirements: <br>- Only contains letters, numbers, hyphens, and underscores <br>- Does not have spaces |
+|`preference_center_title`| Optional | String | The title for the preference center and confirmation pages. If a title is not specified, the title of the pages will default to "Preference Center". |
 |`preference_center_page_html`| Required | String | The HTML for the preference center page. |
 |`confirmation_page_html`| Required | String | The HTML for the confirmation page. |
 {: .reset-td-br-1 .reset-td-br-2 .reset-td-br-3  .reset-td-br-4}
@@ -89,4 +91,4 @@ Refer to the following Liquid tags that can be included in your HTML to generate
 ```
 {% endraw %}
 
-{% endapi %}
+{% endapi %}

_docs/_api/endpoints/preference_center/put_update_preference_center.md

@@ -34,6 +34,7 @@ Authorization: Bearer YOUR-REST-API-KEY
 ```
 {
   "name": "preference_center_name",
+  "preference_center_title": "string",
   "preference_center_page_html": "string",
   "confirmation_page_html": "string"
 }
@@ -44,6 +45,7 @@ Authorization: Bearer YOUR-REST-API-KEY
 | Parameter | Required | Data Type | Description |
 | --------- | ---------| --------- | ----------- |
 |`preference_center_page_html`| Required | String | The HTML for the preference center page. |
+|`preference_center_title`| Optional | String | The title for the preference center and confirmation pages. If a title is not specified, the title of the pages will default to "Preference Center". |
 |`confirmation_page_html`| Required | String | The HTML for the confirmation page. |
 {: .reset-td-br-1 .reset-td-br-2 .reset-td-br-3  .reset-td-br-4}
 
@@ -55,6 +57,7 @@ curl --location --request POST 'https://rest.iad-01.braze.com/preference_center/
 --header 'Authorization: Bearer YOUR-API-KEY-HERE' \
 --data-raw '{
   "name": "Example",
+  "preference_center_title": "Example Preference Center Title",
   "preference_center_page_html": "HTML for preference center here"
   "confirmation_page_html": "HTML here with a message to users here"
 
@@ -73,4 +76,4 @@ curl --location --request POST 'https://rest.iad-01.braze.com/preference_center/
 ```
 {% endraw %}
 
-{% endapi %}
+{% endapi %}

_docs/_api/endpoints/subscription_groups/post_update_user_subscription_group_status.md

@@ -70,8 +70,8 @@ Authorization: Bearer YOUR-REST-API-KEY
 
 This property should not be used for updating a user's profile information. Use the [/users/track]({{site.baseurl}}/api/endpoints/user_data/post_user_track/) property instead.
 
-{% alert important %}
-When creating new users via the [/users/track]({{site.baseurl}}/api/endpoints/user_data/post_user_track/) endpoint, you should leave a delay of around 2 minutes before adding users to the relevant Subscription Group to allow Braze time to fully create the user profile.
+{% alert tip %}
+When creating new users via the [/users/track]({{site.baseurl}}/api/endpoints/user_data/post_user_track/) endpoint, you can set subscription groups within the user attributes object, which allows you to create a user and set the subscription group state in one API call.
 {% endalert %}
 
 ## Request parameters

_docs/_api/endpoints/subscription_groups/post_update_user_subscription_group_status_v2.md

@@ -51,11 +51,10 @@ Authorization: Bearer YOUR-REST-API-KEY
 }
 ```
 
-{% alert important %}
-When creating new users via the [/users/track]({{site.baseurl}}/api/endpoints/user_data/post_user_track/) endpoint, you should leave a delay of around 2 minutes before adding users to the relevant Subscription Group to allow Braze time to fully create the user profile.
+{% alert tip %}
+When creating new users via the [/users/track]({{site.baseurl}}/api/endpoints/user_data/post_user_track/) endpoint, you can set subscription groups within the user attributes object, which allows you to create a user and set the subscription group state in one API call. <br><br>Note that using the [/users/track]({{site.baseurl}}/api/endpoints/user_data/post_user_track/) endpoint to create a new user and update their subscription groups is currently in early access. Contact your Braze customer success manager if you're interested in participating in the early access.
 {% endalert %}
 
-
 ## Request parameters
 
 | Parameter | Required | Data Type | Description |

_docs/_api/endpoints/user_data/post_user_track.md

@@ -145,6 +145,42 @@ curl --location --request POST 'https://rest.iad-01.braze.com/users/track' \
 }`
 ```
 
+## Example request to set subscription groups
+
+This example shows how you can create a user and set their subscription group within the user attributes object.
+
+{% alert important %}
+Using endpoint to create a new user and update their subscription groups is currently in early access. Contact your Braze customer success manager if you're interested in participating in the early access.
+{% endalert %}
+
+```
+curl --location --request POST 'https://rest.iad-01.braze.com/users/track' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer YOUR-API-KEY-HERE' \
+--data-raw '{
+  "attributes": [
+  {
+    "external_id": "user_identifier",
+    "email": "example@email.com",
+    "email_subscribe": "subscribed",
+    "subscription_groups" : [{
+      "subscription_group_id": "subscription_group_identifier_1",
+      "subscription_state": "unsubscribed"
+      },
+      {
+        "subscription_group_id": "subscription_group_identifier_2",
+        "subscription_state": "subscribed"
+        },
+        {
+          "subscription_group_id": "subscription_group_identifier_3",
+          "subscription_state": "subscribed"
+        }
+      ]
+    }
+  ]
+}'
+```
+
 ## Responses
 
 When using any of the aforementioned API requests, you should receive one of the following three general responses:

_docs/_api/objects_filters/user_attributes_object.md

@@ -115,6 +115,7 @@ The following user profile fields are case sensitive, so be sure to reference th
 | phone | (string) |
 | push_subscribe | (string) Available values are "opted_in" (explicitly registered to receive push messages), "unsubscribed" (explicitly opted out of push messages), and "subscribed" (neither opted in nor out).  |
 | push_tokens | Array of objects with `app_id` and `token` string. You may optionally provide a `device_id` for the device this token is associated with, e.g., `[{"app_id": App Identifier, "token": "abcd", "device_id": "optional_field_value"}]`. If a `device_id` is not provided, one will be randomly generated. |
+| subscription_groups| Array of objects with `subscription_group_id` and `subscription_state` string. |
 | time_zone | (string) Of time zone name from [IANA Time Zone Database][26] (e.g., "America/New_York" or "Eastern Time (US & Canada)"). Only valid time zone values will be set. |
 | twitter | Hash containing any of `id` (integer), `screen_name` (string, Twitter handle), `followers_count` (integer), `friends_count` (integer), `statuses_count` (integer). |
 {: .reset-td-br-1 .reset-td-br-2}
@@ -123,6 +124,8 @@ Language values that are explicitly set via this API will take precedence over t
 
 ####  User attribute example request
 
+This example contains two user attribute objects with the allowed 75 requests per API call.
+
 ```json
 POST https://YOUR_REST_API_URL/users/track
 Content-Type: application/json
@@ -147,14 +150,11 @@ Authorization: Bearer YOUR-REST-API-KEY
       "user_alias" : { "alias_name" : "device123", "alias_label" : "my_device_identifier"},
       "first_name" : "Alice",
       "has_profile_picture" : false,
-    }
+    },
   ]
 }
 ```
 
-This example contains two User Attribute objects of the allowed 75 per API call.
-
-
 [2]: {{site.baseurl}}/user_guide/data_and_analytics/user_data_collection/language_codes/
 [3]: {{site.baseurl}}/help/help_articles/push/push_token_migration/
 [6]: {{site.baseurl}}/developer_guide/platform_wide/analytics_overview/#arrays

_docs/_developer_guide/platform_integration_guides/android/in-app_messaging/integration.md

@@ -207,7 +207,6 @@ class MyApplication : Application() {
 {% endtab %}
 {% endtabs %}
 
-See the [`BrazeActivityLifecycleCallbackListener`][83] constructor KDocs for more information.
 
 [34]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.ui.inappmessage/-braze-in-app-message-manager/index.html
 [69]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.ui.inappmessage/-braze-in-app-message-manager/ensure-subscribed-to-in-app-message-events.html
@@ -225,7 +224,6 @@ See the [`BrazeActivityLifecycleCallbackListener`][83] constructor KDocs for mor
 [50]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.models.inappmessage/-message-button/index.html
 [51]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.models.inappmessage/-in-app-message-html-full/index.html
 [52]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.models.inappmessage/-i-in-app-message-html/index.html
-[83]: https://www.braze.com/customers
 [84]: {{site.baseurl}}/user_guide/message_building_by_channel/push/best_practices/
 [90]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.models.inappmessage/-in-app-message-modal/index.html
 [91]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.models.inappmessage/-in-app-message-slideup/index.html