From f22591e2f0bfe4f080993e3c608e869837486acd Mon Sep 17 00:00:00 2001
From: avinashp-plivo <avinash.p@plivo.com>
Date: Mon, 27 Jul 2026 12:20:58 +0530
Subject: [PATCH 1/3] feat(tollfree-verification): support 4 new optional
 Zipwhip TF fields

Adds the following optional parameters to the toll-free verification
create and update APIs:

  terms_and_conditions_link
  privacy_policy_link
  optin_message
  help_message

All four are optional and backward compatible; existing callers are
unaffected. Mirrors the corresponding porter API change.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 .../TollfreeVerificationCreator.java          | 40 ++++++++++++++
 .../TollfreeVerificationUpdater.java          | 40 ++++++++++++++
 .../plivo/api/TollfreeVerificationTest.java   | 55 +++++++++++++++++++
 3 files changed, 135 insertions(+)

diff --git a/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationCreator.java b/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationCreator.java
index e09a7386..a8eda207 100644
--- a/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationCreator.java
+++ b/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationCreator.java
@@ -16,6 +16,10 @@ public class TollfreeVerificationCreator extends Creator<TollfreeVerificationCre
   private String volume;
   private String additionalInformation;
   private String extraData;
+  private String termsAndConditionsLink;
+  private String privacyPolicyLink;
+  private String optinMessage;
+  private String helpMessage;
   private String callbackUrl;
   private String callbackMethod;
 
@@ -119,6 +123,42 @@ public TollfreeVerificationCreator extraData(final String extraData) {
     return this;
   }
 
+  public String termsAndConditionsLink() {
+    return termsAndConditionsLink;
+  }
+
+  public TollfreeVerificationCreator termsAndConditionsLink(final String termsAndConditionsLink) {
+    this.termsAndConditionsLink = termsAndConditionsLink;
+    return this;
+  }
+
+  public String privacyPolicyLink() {
+    return privacyPolicyLink;
+  }
+
+  public TollfreeVerificationCreator privacyPolicyLink(final String privacyPolicyLink) {
+    this.privacyPolicyLink = privacyPolicyLink;
+    return this;
+  }
+
+  public String optinMessage() {
+    return optinMessage;
+  }
+
+  public TollfreeVerificationCreator optinMessage(final String optinMessage) {
+    this.optinMessage = optinMessage;
+    return this;
+  }
+
+  public String helpMessage() {
+    return helpMessage;
+  }
+
+  public TollfreeVerificationCreator helpMessage(final String helpMessage) {
+    this.helpMessage = helpMessage;
+    return this;
+  }
+
   public String additionalInformation() {
     return additionalInformation;
   }
diff --git a/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationUpdater.java b/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationUpdater.java
index bc5f5240..6f95da86 100644
--- a/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationUpdater.java
+++ b/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationUpdater.java
@@ -15,6 +15,10 @@ public class TollfreeVerificationUpdater extends Updater<TollfreeVerificationUpd
   private String volume;
   private String additionalInformation;
   private String extraData;
+  private String termsAndConditionsLink;
+  private String privacyPolicyLink;
+  private String optinMessage;
+  private String helpMessage;
   private String callbackURL;
   private String callbackMethod;
 
@@ -117,6 +121,42 @@ public TollfreeVerificationUpdater extraData(final String extraData) {
     return this;
   }
 
+  public String termsAndConditionsLink() {
+    return termsAndConditionsLink;
+  }
+
+  public TollfreeVerificationUpdater termsAndConditionsLink(final String termsAndConditionsLink) {
+    this.termsAndConditionsLink = termsAndConditionsLink;
+    return this;
+  }
+
+  public String privacyPolicyLink() {
+    return privacyPolicyLink;
+  }
+
+  public TollfreeVerificationUpdater privacyPolicyLink(final String privacyPolicyLink) {
+    this.privacyPolicyLink = privacyPolicyLink;
+    return this;
+  }
+
+  public String optinMessage() {
+    return optinMessage;
+  }
+
+  public TollfreeVerificationUpdater optinMessage(final String optinMessage) {
+    this.optinMessage = optinMessage;
+    return this;
+  }
+
+  public String helpMessage() {
+    return helpMessage;
+  }
+
+  public TollfreeVerificationUpdater helpMessage(final String helpMessage) {
+    this.helpMessage = helpMessage;
+    return this;
+  }
+
   public String callbackURL() {
     return callbackURL;
   }
diff --git a/src/test/java/com/plivo/api/TollfreeVerificationTest.java b/src/test/java/com/plivo/api/TollfreeVerificationTest.java
index 9b4c62bb..5019bbb4 100644
--- a/src/test/java/com/plivo/api/TollfreeVerificationTest.java
+++ b/src/test/java/com/plivo/api/TollfreeVerificationTest.java
@@ -1,5 +1,6 @@
 package com.plivo.api;
 
+import com.fasterxml.jackson.databind.JsonNode;
 import com.plivo.api.models.tollfree_verification.TollfreeVerification;
 import com.squareup.okhttp.mockwebserver.MockResponse;
 import com.squareup.okhttp.mockwebserver.RecordedRequest;
@@ -65,6 +66,60 @@ public void tollfreeVerificationCreateWithMandatoryParamsShouldSucceed() throws
 
     assertRequest("POST", "TollfreeVerification/");
   }
+  @Test
+  public void tollfreeVerificationCreateWithZipwhipFieldsShouldSucceed() throws Exception {
+    expectResponse("tollfreeVerificationCreateResponse.json", 201);
+
+    TollfreeVerification.creator()
+      .profileUuid("fb239ee1-fb5c-4dd9-b55c-5cf10170e756")
+      .number("18557312530")
+      .usecase("FRAUD_ALERT")
+      .usecaseSummary("summary")
+      .optinImageUrl("https://wwww.optinurl.com")
+      .optinType("VERBAL")
+      .messageSample("message sample")
+      .volume("10")
+      .additionalInformation("additional information")
+      .extraData("extra data")
+      .termsAndConditionsLink("https://www.example.com/terms")
+      .privacyPolicyLink("https://www.example.com/privacy")
+      .optinMessage("Reply YES to opt in")
+      .helpMessage("Reply HELP for help")
+      .callbackMethod("POST")
+      .callbackUrl("https://www.callbackurl.com")
+      .create();
+
+    JsonNode payload = actualRequestPayload();
+    assertEquals("https://www.example.com/terms", payload.get("terms_and_conditions_link").asText());
+    assertEquals("https://www.example.com/privacy", payload.get("privacy_policy_link").asText());
+    assertEquals("Reply YES to opt in", payload.get("optin_message").asText());
+    assertEquals("Reply HELP for help", payload.get("help_message").asText());
+  }
+
+  @Test
+  public void tollfreeVerificationUpdateWithZipwhipFieldsShouldSucceed() throws Exception {
+    String fixtureName = "tollfreeVerificationUpdateResponse.json";
+    String uuid = "uuid";
+
+    server.enqueue(new MockResponse()
+      .setResponseCode(200)
+      .setBody(loadFixture(fixtureName))
+    );
+
+    TollfreeVerification.updater(uuid)
+      .termsAndConditionsLink("https://www.example.com/terms")
+      .privacyPolicyLink("https://www.example.com/privacy")
+      .optinMessage("Reply YES to opt in")
+      .helpMessage("Reply HELP for help")
+      .update();
+
+    JsonNode payload = actualRequestPayload();
+    assertEquals("https://www.example.com/terms", payload.get("terms_and_conditions_link").asText());
+    assertEquals("https://www.example.com/privacy", payload.get("privacy_policy_link").asText());
+    assertEquals("Reply YES to opt in", payload.get("optin_message").asText());
+    assertEquals("Reply HELP for help", payload.get("help_message").asText());
+  }
+
   @Test
   public void tollfreeVerificationGetShouldSucceed() throws Exception {
     String uuid = "uuid";

From e8cf17cf5e8a90dada6230e8d943d9a17e2495d0 Mon Sep 17 00:00:00 2001
From: avinashp-plivo <avinash.p@plivo.com>
Date: Mon, 27 Jul 2026 13:27:34 +0530
Subject: [PATCH 2/3] chore: bump version to 5.50.0 and update changelog

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md                                 | 4 ++++
 src/main/resources/com/plivo/api/version.txt | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7d6087eb..69d6a07e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Change Log
 
+## [5.50.0](https://github.com/plivo/plivo-java/tree/v5.50.0) (2026-07-27)
+**Feature - Toll-free verification terms, privacy, opt-in and help fields**
+- Added optional `termsAndConditionsLink`, `privacyPolicyLink`, `optinMessage` and `helpMessage` parameters to the toll-free verification create and update methods
+
 ## [5.49.0](https://github.com/plivo/plivo-java/tree/v5.49.0) (2026-06-11)
 **Feature - complianceApplicationId on phone number buy**
 - Added an optional `complianceApplicationId` builder param to `PhoneNumberCreator`, serialized to the `compliance_application_id` wire param on phone number buy
diff --git a/src/main/resources/com/plivo/api/version.txt b/src/main/resources/com/plivo/api/version.txt
index 357e1c72..24091d30 100644
--- a/src/main/resources/com/plivo/api/version.txt
+++ b/src/main/resources/com/plivo/api/version.txt
@@ -1 +1 @@
-5.49.0
+5.50.0

From 5dd83dfd4cba01b2fe21bfab966baf6358d8a549 Mon Sep 17 00:00:00 2001
From: avinashp-plivo <avinash.p@plivo.com>
Date: Tue, 28 Jul 2026 12:27:35 +0530
Subject: [PATCH 3/3] chore: update release date to 2026-07-28

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 69d6a07e..2ab543dc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Change Log
 
-## [5.50.0](https://github.com/plivo/plivo-java/tree/v5.50.0) (2026-07-27)
+## [5.50.0](https://github.com/plivo/plivo-java/tree/v5.50.0) (2026-07-28)
 **Feature - Toll-free verification terms, privacy, opt-in and help fields**
 - Added optional `termsAndConditionsLink`, `privacyPolicyLink`, `optinMessage` and `helpMessage` parameters to the toll-free verification create and update methods