--- title: Peach API Integration on Truto slug: peach category: Payment Gateway canonical: "https://truto.one/integrations/detail/peach/" --- # Peach API Integration on Truto **Category:** Payment Gateway **Status:** Generally available ## MCP-ready AI tools Truto exposes 10 tools for Peach that AI agents can call directly. - **get_single_peach_campaign_by_id** — Get a specific peach campaign by id. Returns: updatedAt, type, limit, startDate, endDate. Required: id. - **peach_campaigns_get_stats** — Get detailed public statistics for a specific peach campaign including total amount raised, donation count, and per-group breakdowns. Returns: limit, startDate, endDate. Required: account_id, campaign_id. - **create_a_peach_payment** — Create a payment in Peach. Returns the created payment object including paymentId, status, donationSum, donationCurrency, donorDisplayName, email, campaignId, and createdAt. Required: sum. Currency defaults to ILS; billingCycles is required when isSubscription is true. - **update_a_peach_payment_by_id** — Update a payment in Peach by performing an action such as canceling a subscription, changing the charge day, freezing, or updating a payment field. Returns: message. Required: id, action. - **create_a_peach_contact** — Create a new contact in Peach. Returns: contactBody, contactResponse, contactId, failedCustomProperties. Required: firstName, lastName, email. - **get_single_peach_contact_by_id** — Get a single Peach contact by contactId, email, phoneNumber, or tz. Returns: email, contactId. At least one of contactId, email, phoneNumber, or tz must be provided. - **update_a_peach_contact_by_id** — Update an existing Peach contact by id. Returns: success, message, contact. Required: id. - **peach_contacts_bulk_delete** — Delete a Peach contact by contactId. Returns: success, message. Required: contactId. - **peach_interactions_create_note** — Create a note for a contact in Peach. Returns the created note object (noteBody) with category, contactId, noteTitle, noteBody, and source, plus an interactionResponse identifier. Required: contactId, noteBody. - **list_all_peach_search_transactions** — Search Peach transactions within a date range, optionally filtered by campaign. Returns: createdAt, updatedAt. Date range defaults to the last 30 days; max 1000 results per page. ## How it works 1. **Link your customer's Peach account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Peach.** The Proxy API is a 1-to-1 mapping of the Peach API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Power giving-day platforms with live campaign stats** — Fundraising and crowdfunding SaaS products can process donations through Peach and pull real-time campaign statistics to render live thermometers, leaderboards, and ambassador rankings on their own frontends. - **Sync donor identities into nonprofit CRMs** — Donor management and CRM platforms can create and update Peach contacts—including the Israeli `tz` needed for tax receipts—so donor records stay consistent across the nonprofit's stack without manual data entry. - **Automate donor win-back and engagement workflows** — Marketing automation tools can react to donation activity, trigger email sequences, and log those touchpoints as notes on the donor's Peach profile so nonprofit staff have a unified interaction history. - **Automate nonprofit bookkeeping and reconciliation** — Accounting and ERP SaaS built for nonprofits can pull transactions from Peach on a schedule, categorize them by campaign, and reconcile donation amounts against bank deposits—eliminating manual CSV exports. - **Enable self-serve donor portals for recurring giving** — SaaS products can let donors or nonprofit admins manage subscriptions—updating or canceling recurring gifts—directly inside a third-party dashboard by calling Peach's payment update endpoint. ## What you can build - **Live fundraising thermometer and leaderboard** — Use campaign stats to render real-time totals raised, donor counts, and per-ambassador breakdowns on your platform's public campaign pages. - **Donor profile sync with Israeli tax compliance** — Create and update Peach contacts with `tz`, email, phone, and name so your CRM stays deduplicated and tax-receipt-ready. - **Recurring donation management console** — Let admins or donors update, pause, or cancel subscription payments in Peach from your own dashboard via the payment update endpoint. - **Nightly transaction reconciliation job** — Search Peach transactions by date range and campaign to feed a general ledger, categorize donations, and match them to deposits. - **Donor timeline enrichment** — Append contextual notes to a donor's Peach profile whenever they engage with your platform—emails opened, events attended, or forms submitted. - **Bulk donor cleanup tooling** — Offer admins the ability to remove test or duplicate donor records at scale using Peach's bulk contact delete operation. ## FAQs ### How does authentication with Peach work through Truto? Your end users connect their Peach account through Truto's managed auth flow. Truto stores and refreshes credentials so your application never handles Peach API keys directly. ### Which Peach operations are supported today? The current integration supports creating and updating payments, creating/reading/updating contacts and bulk-deleting them, creating interaction notes, fetching a single campaign by ID, retrieving campaign statistics, and searching transactions. ### Can I manage recurring donations (subscriptions) via the API? Yes. Recurring gifts are represented as payments with `isSubscription` and `billingCycles`, and you can modify them—for example to pause or cancel—using the update payment endpoint. ### Does the integration support Israeli tax compliance fields like `tz`? Yes. The contact endpoints accept the `tz` (Israeli national ID / company number) alongside standard PII, which is what Peach uses to generate tax-deductible receipts. ### How fresh is campaign and transaction data? Data is fetched on demand from Peach's API at call time, so campaign stats and transaction searches reflect Peach's latest state. For live leaderboards or reconciliation jobs, you control the polling cadence. ### Can I search historical transactions for reconciliation? Yes. The transaction search endpoint lets you filter by date range and campaign, which is the primary building block for nightly reconciliation and finance reporting workflows. ## Related reading - [Connect Peach to Claude: Sync Donor Data and Monitor Fundraising](https://truto.one/blog/connect-peach-to-claude-sync-donor-data-and-monitor-fundraising/) — Learn how to build a managed MCP server for Peach. Give Claude secure read and write access to campaigns, donors, and payments without managing API infrastructure. - [Connect Peach to ChatGPT: Manage Campaigns and Process Payments](https://truto.one/blog/connect-peach-to-chatgpt-manage-campaigns-and-process-payments/) — Learn how to securely connect Peach to ChatGPT using a managed MCP server to automate campaigns, process payments, and sync donor data via natural language. - [Connect Peach to AI Agents: Automate Contacts and Payment Flows](https://truto.one/blog/connect-peach-to-ai-agents-automate-contacts-and-payment-flows/) — Learn how to connect Peach to AI agents using Truto's /tools endpoint. A complete guide to automating donor management, payment processing, and campaigns.