From cf304e8f37b904120a048cd6ecb61d72276306dc Mon Sep 17 00:00:00 2001
From: dd-votes <117858030+dd-votes@users.noreply.github.com>
Date: Thu, 9 May 2024 10:23:03 -0400
Subject: [PATCH] feature/sc-16547/docs-add-section-for-pledge-to-vote

---
 docs/software/events.md       | 35 +++++++++++++++++++++++++++++++++++
 docs/software/exportformat.md | 30 ++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+)

diff --git a/docs/software/events.md b/docs/software/events.md
index b5e4ada..a8af31a 100644
--- a/docs/software/events.md
+++ b/docs/software/events.md
@@ -157,6 +157,41 @@ The `method` property will provide more details about what took place. Possible
 * `pdf` - After clicking on a link to visit a state voter registration website, the user returned and indicated they wanted to register by mail instead. They received an email with a PDF registration form to print and mail.
 
 
+### Pledge Tool
+
+#### action-start event
+
+Fired when the user submits the Pledge tool intake form.
+
+```json-doc
+{
+  event: "action-start",
+  tool: "pledge",
+  state: "[STATE]",
+  first_name: "[FIRST NAME]",
+  last_name: "[LAST NAME]",
+  email: "[EMAIL]",
+  zipcode: "[ZIP CODE]"    
+}
+```
+
+#### action-finish event
+
+Fired when the user receives confirmation that they have pledged to vote and subscribed to election reminders (we expect this to immediately follow form submission).
+
+```json-doc
+{
+  event: "action-finish",
+  tool: "pledge",
+  state: "[STATE]",
+  first_name: "[FIRST NAME]",
+  last_name: "[LAST NAME]",
+  email: "[EMAIL]",
+  zipcode: "[ZIP CODE]"    
+}
+```
+
+
 ### Register Tool
 
 #### action-start event
diff --git a/docs/software/exportformat.md b/docs/software/exportformat.md
index 69673f7..19be322 100644
--- a/docs/software/exportformat.md
+++ b/docs/software/exportformat.md
@@ -115,6 +115,36 @@ are still included in reporting to provide access to historic data. Deprecated c
 | Updated At (UTC)      | The date and time when this action's data was last updated, in UTC                           |
 
 
+## Pledge Tool Export Format
+
+| Column Title          | Description                                                                           |
+|-----------------------|---------------------------------------------------------------------------------------|
+| ID                    | The ID we store internally for the verification                                       |
+| Subscriber            | The name of the subscriber                                                            |
+| Time Started (UTC)    | The time that the first page of the verification was done                             |
+| First Name            | The user's first name                                                                 |
+| Last Name             | The user's last name                                                                  |
+| Date of Birth         | The date of birth of the user                                                         |
+| Email                 | The email address of the user                                                         |
+| Phone                 | The phone number of the user                                                          |
+| Address 1             | The user's Address1                                                                   |
+| Address 2             | The user's Address2                                                                   |
+| City                  | The user's city                                                                       |
+| Zipcode               | The user's zipcode                                                                    |
+| State                 | The user's state                                                                      |
+| Pledged Election Date | The user's pledged election date.                                                     |
+| Subscriber SMS Opt In | True/False if the user opted into the subscriber's SMS list                           |
+| source                | The ?source= query param                                                              |
+| utm_source            | The ?utm_source= query param                                                          |
+| utm_medium            | The ?utm_medium= query param                                                          |
+| utm_campaign          | The ?utm_campaign= query param                                                        |
+| utm_content           | The ?utm_content= query param                                                         |
+| utm_term              | The ?utm_term= query param                                                            |
+| Embed URL             | For submissions done inside an embed, the URL of the page where the tool was embedded |
+| Session ID            | The ID of a user's session. For tracking users across multiple tools or visits.       |
+| Updated At (UTC)      | The date and time when this action's data was last updated, in UTC                    |
+
+
 ## Register Tool Export Format
 
 | Column Title                             | Description                                                                                                                                                                                                                                    |