You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**Auth Proxy Update: appName becomes a required parameter (12/8/2025)**
160
+
### Breaking Change: `appName` Required
161
161
162
162
<Warning>
163
-
**Auth Proxy: appName becomes a required parameter**
163
+
**Effective December 8, 2025**
164
+
165
+
Beginning the week of December 8, 2025, all email-based OTP and recovery activities will require the `appName` parameter. Existing SDK versions will continue working, but upgrading without setting an `appName` will break email-based flows.
166
+
167
+
<CardGroupcols={2}>
168
+
<Cardtitle="Auth Proxy Users"icon="server">
169
+
**Affected:** Anyone using Auth Proxy without `appName` set
170
+
171
+
**Action:** Set `appName` under [email configuration](https://app.turnkey.com/dashboard/walletKit)
172
+
</Card>
173
+
<Cardtitle="Server SDK Users"icon="code">
174
+
**Affected:** Users calling `init_otp_auth`, `init_otp`, `email_recovery`, or `email_auth` without `appName`
175
+
176
+
**Action:**<br/>
177
+
• For `email_recovery` or `email_auth`: include `appName` in your request<br/>
178
+
• For `init_otp` or `init_otp_auth`: update your API call to match the new input structure when upgrading to the latest server-SDK
179
+
</Card>
180
+
</CardGroup>
181
+
182
+
<Accordiontitle="Policy activity type updates">
183
+
If you manage email flows with policies, update to the new activity types:
Beginning the week of **December 8 2025**, all new versionf of email-based OTP and recovery activities will **require the appName parameter**. Until this point the appName is optional. We’re releasing a new major version of our <u>server SDKs</u> which will introduce a **major version bump.**
167
-
168
-
- The **appName** will become a **required** field in updated email activities
169
-
170
-
Existing SDK versions will continue working, but upgrading without setting an **appName** will break email-based flows.\
171
-
\
172
-
**<u>Who is Affected</u>**\
173
-
**Auth Proxy users**: Anyone using the Auth Proxy without an appName set
174
-
175
-
**Server SDK users:**
176
-
177
-
- Users who do not specify an appName, and/or
178
-
- Any user calling email-based flows, including:
179
-
- Init_otp_auth
180
-
- Init_otp
181
-
- Email_recovery
182
-
- Email_auth
183
-
184
-
**<u>What You Will Need To Do</u>**
185
-
186
-
**Auth Proxy users:**
187
-
188
-
- Ensure there is an **appName** set under email configuration, [<u>here</u>](https://app.turnkey.com/dashboard/walletKit)
189
-
190
-
**Server-SDK users:**
191
-
192
-
- For those using email_recovery or email_auth
193
-
- Ensure you include an **AppName** in your request
194
-
- For those using init_otp or init_otp_auth: When upgrading to the newest server-SDK (a major version), you **must** update your API call to match the new input structure
195
-
196
-
**If you are using policies to manage email flows:**
We also support custom HTML email templates for [Enterprise](https://www.turnkey.com/pricing) clients on the **Scale** tier. This allows you to inject arbitrary data from a JSON string containing key-value pairs. In this case, the `emailCustomization` variable may look like:
0 commit comments