From 8eef06f0cff8c4bfc01134d81053bfec16e2caa2 Mon Sep 17 00:00:00 2001
From: Will Strinz <will.strinz@drip.com>
Date: Thu, 22 Oct 2026 12:47:15 -0500
Subject: [PATCH] Document include_metrics and primary_purpose for Single-Email
 Campaigns

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 source/includes/rest/_broadcasts.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/source/includes/rest/_broadcasts.md b/source/includes/rest/_broadcasts.md
index 030220eb6c9..93b43af4565 100644
--- a/source/includes/rest/_broadcasts.md
+++ b/source/includes/rest/_broadcasts.md
@@ -157,6 +157,10 @@ with [Set the audience](#set-the-audience).
       <td><code>derived</code></td>
       <td>Read-only text generated when the campaign is read. <code>derived.audience</code> describes who it goes to in plain English, such as <code>People who are in the "VIP customers" segment</code>, or <code>All people</code>. It is display text: do not parse it, and expect its wording to change.</td>
     </tr>
+    <tr>
+      <td><code>metrics</code></td>
+      <td>Present only when the request includes <code>include_metrics=true</code>. An object with the campaign's <code>send_count</code>, <code>open_count</code>, <code>click_count</code> and <code>unsubscribe_count</code>.</td>
+    </tr>
     <tr>
       <td><code>links</code></td>
       <td>An object containing the account's REST API URL.</td>
@@ -321,6 +325,10 @@ client.listBroadcasts(options)
       <td><code>direction</code></td>
       <td>Optional. Filter sort direction with: <code>asc</code> or <code>desc</code>. Defaults to <code>asc</code>.</td>
     </tr>
+    <tr>
+      <td><code>include_metrics</code></td>
+      <td>Optional. Include <code>include_metrics=true</code> to add a <code>metrics</code> object to each Single-Email Campaign; leave it out to omit them.</td>
+    </tr>
   </tbody>
 </table>
 
@@ -546,7 +554,20 @@ client.fetchBroadcast(broadcastId)
 
 ### Arguments
 
-None.
+<table>
+  <thead>
+    <tr>
+      <th>Key</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>include_metrics</code></td>
+      <td>Optional. Include <code>include_metrics=true</code> to add a <code>metrics</code> object to the Single-Email Campaign; leave it out to omit it.</td>
+    </tr>
+  </tbody>
+</table>
 
 ## Update a Single-Email Campaign
 
@@ -692,6 +713,10 @@ Status, scheduling, and the audience are not updated here. Each has its own endp
       <td><code>postal_address</code></td>
       <td>Optional. A physical mailing address for CAN-SPAM compliance.</td>
     </tr>
+    <tr>
+      <td><code>primary_purpose</code></td>
+      <td>Optional. Either <code>commercial</code> or <code>transactional</code>. A transactional Single-Email Campaign's audience also includes people who have unsubscribed. Use <code>transactional</code> only for messages a person needs whatever their email preferences, such as receipts or account notices. New Single-Email Campaigns are created as <code>commercial</code>.</td>
+    </tr>
   </tbody>
 </table>