{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Contact Information Management Guide","siteUrl":"https://docs.peachfinance.com","description":"API and product documentation for Peach Finance, a lending-as-a-service platform.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"contact-information-management-guide","__idx":0},"children":["Contact Information Management Guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide shows you how to manage contact information in Peach, continuing with our borrower James Smith from the Quickstart guide. You'll learn how to view existing contacts and add secondary contact information."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each borrower in Peach can have multiple contact records:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Primary contacts (for main communications)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Secondary contacts (for backup or work information)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Additional contacts (for special purposes)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understanding-contact-properties","__idx":2},"children":["Understanding Contact Properties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each contact in Peach has important properties that determine how it's used:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"status-levels","__idx":3},"children":["Status Levels"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["primary"]}," - Main contact for notifications and portal display"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["secondary"]}," - Alternative contact methods"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additional"]}," - Extra contacts for special purposes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["archived"]}," - Historical information."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"labels","__idx":4},"children":["Labels"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personal"]}," - Personal contact methods"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["work"]}," - Work-related contacts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["home"]}," - Home contact information"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["military"]}," - Military contact details"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validation-states","__idx":5},"children":["Validation States"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["valid"]}," - Contact is not known to be disconnected or otherwise unusable. (e.g., if a carrier responds that a phone number is disconnected, this would be set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verified"]}," - Contact has been verified (e.g., through confirmation code)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":6},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, make sure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Peach account with API access"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your API key"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Borrower ID"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note"]},": The following examples use commonly used fields, but for full details, including additional data and parameters, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-docs/api-public"},"children":["API Reference"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"check-existing-contacts","__idx":7},"children":["Check Existing Contacts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Let's first verify James's current contact information that we set up in the Quickstart:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /people/{personId}/contacts\nX-API-KEY: <YOUR-API-KEY>\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response should show his primary contacts:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": 200,\n  \"count\": 3,\n  \"data\": [\n    {\n      \"id\": \"CT-ABCD-1234\",\n      \"contactType\": \"email\",\n      \"label\": \"personal\",\n      \"affiliation\": \"self\",\n      \"status\": \"primary\",\n      \"value\": \"james.smith@example.com\",\n      \"valid\": true,\n      \"verified\": true\n    },\n    {\n      \"id\": \"CT-EFGH-5678\",\n      \"contactType\": \"phone\",\n      \"label\": \"mobile\", \n      \"affiliation\": \"self\",\n      \"status\": \"primary\",\n      \"value\": \"+14155551234\",\n      \"valid\": true,\n      \"verified\": true,\n      \"receiveTextMessages\": true\n    },\n    {\n      \"id\": \"CT-IJKL-9012\",\n      \"contactType\": \"address\",\n      \"label\": \"home\",\n      \"affiliation\": \"self\",\n      \"status\": \"primary\",\n      \"address\": {\n        \"addressLine1\": \"1 Main St\",\n        \"city\": \"Houston\",\n        \"state\": \"TX\",\n        \"postalCode\": \"77002\",\n        \"country\": \"US\"\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-secondary-contact-information","__idx":8},"children":["Add Secondary Contact Information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now let's add James' work contact information as secondary contacts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-work-email","__idx":9},"children":["Add Work Email"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /people/{personId}/contacts\nX-API-KEY: <YOUR-API-KEY>\nContent-Type: application/json\n\n{\n  \"contactType\": \"email\",\n  \"label\": \"work\",\n  \"affiliation\": \"self\",\n  \"status\": \"secondary\",\n  \"value\": \"jsmith@company.com\",\n  \"valid\": true,\n  \"verified\": false\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-work-phone","__idx":10},"children":["Add Work Phone"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /people/{personId}/contacts\nX-API-KEY: <YOUR-API-KEY>\nContent-Type: application/json\n\n{\n  \"contactType\": \"phone\",\n  \"label\": \"work\",\n  \"affiliation\": \"self\",\n  \"status\": \"secondary\",\n  \"value\": \"+14155559876\",\n  \"valid\": true,\n  \"verified\": false,\n  \"receiveTextMessages\": false\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"portal-display-and-notifications","__idx":11},"children":["Portal Display and Notifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Peach Borrower Portal automatically uses specific contacts:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Portal Display"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Primary personal/work email"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Primary personal mobile phone"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Primary home address"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notification System"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Emails: Sends to primary self-affiliated email"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Text messages: Uses primary personal phone with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receiveTextMessages: true"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Physical mail: Uses primary home address"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":12},"children":["Best Practices"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact Organization"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep one primary email, phone, and address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mark work contacts as secondary"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Archive outdated contacts"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Phone Numbers"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Always include the country code"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receiveTextMessages: true"]}," only with consent"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use proper formatting (e.g., +1XXXXXXXXXX)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email Addresses"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify email format before submission"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consider verification status when sending important notices"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use appropriate labels for different email types"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"peach-borrower-portal-contact-requirements-and-validation","__idx":13},"children":["Peach Borrower Portal Contact Requirements and Validation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are the key requirements to ensure proper contact setup in Peach's Borrower Portal (if applicable):"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Portal Display Requirements"]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EMAIL"]},": contactType=email, label=personal/work, affiliation=self, status=primary"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MOBILE PHONE"]},": contactType=phone, label=personal, affiliation=self, status=primary"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HOME PHONE"]},": contactType=phone, label=home, affiliation=self, status=secondary"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HOME ADDRESS"]},": contactType=address, label=home, affiliation=self, status=primary"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notice Delivery Requirements"]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Email notices: contactType=email, valid=true, affiliation=self, status=primary"," ","(falls back to secondary, then additional if primary not found)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Text messages: contactType=phone, valid=true, affiliation=self, receiveTextMessages=true, label=personal, status=primary"," ","(falls back to secondary, then additional if primary not found)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Following these requirements ensures proper display in the Borrower Portal and reliable notice delivery."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":14},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn how to manage borrower ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/borrowers/identities"},"children":["Identities"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set up ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/borrowers/payment-instruments"},"children":["Payment Instruments"]}," for collecting payments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure outbound notifications and templates in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/communications/"},"children":["Communications"]}]}]}]},"headings":[{"value":"Contact Information Management Guide","id":"contact-information-management-guide","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Understanding Contact Properties","id":"understanding-contact-properties","depth":2},{"value":"Status Levels","id":"status-levels","depth":3},{"value":"Labels","id":"labels","depth":3},{"value":"Validation States","id":"validation-states","depth":3},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Check Existing Contacts","id":"check-existing-contacts","depth":2},{"value":"Add Secondary Contact Information","id":"add-secondary-contact-information","depth":2},{"value":"Add Work Email","id":"add-work-email","depth":3},{"value":"Add Work Phone","id":"add-work-phone","depth":3},{"value":"Portal Display and Notifications","id":"portal-display-and-notifications","depth":2},{"value":"Best Practices","id":"best-practices","depth":2},{"value":"Peach Borrower Portal Contact Requirements and Validation","id":"peach-borrower-portal-contact-requirements-and-validation","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Contact Information Management Guide"}},"lastModified":"2026-05-01T14:33:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/borrowers/contact-information","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}