> For the complete documentation index, see [llms.txt](https://peach-organization.gitbook.io/peach/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://peach-organization.gitbook.io/peach/webhooks/webhooks-for-automations/message-to-ambassador-about-new-donation-webhook.md). # Message to ambassador about new donation webhook When a donation is received through an ambassador , an automation can be triggered. The ambassador and donation details can be sent to the endpoint of your choice #### Event Payload Fields | Parameter | Values | Description | | --------------------------------- | ------------------ | ----------------------------------------------------------- | | automationTrigger | string | Event type that triggered this action (`ambassadorSendMsg`) | | contactId | string (UUID) | Ambassador’s contact ID | | paymentDate | number (timestamp) | Date of the donation | | donorFirstName | string | Donor’s first name | | donorLastName | string | Donor’s last name | | email | string (email) | Donor’s email address | | documentLanguage | string | Language for the receipt / message | | donationCurrency | string (ISO 4217) | Currency of the donation | | paymentType | string | Payment method type (`bankTransfer`, `card`, etc.) | | donationSum | number | Amount donated | | otherDescription | string | Additional donation description | | isHok | boolean | Whether the donation is part of a standing order | | isInstallments | boolean | Whether the donation is split into installments | | accountId | string | Account ID associated with the donation | | donationMethod | string | Method of donation (manual, API, form) | | campaignId | string | Campaign ID related to this donation | | exchangeRate | number | Exchange rate applied (to default currency) | | tz | string | Donor Israeli ID / company number | | donorPersonalDedication | string | Personal dedication message from donor | | donorDisplayName | string | Donor display name (first + last) | | receiptEmail | string | Email where receipt is sent | | donorPhoneNumber | string | Donor phone number | | paymentId | string (UUID) | Payment record ID | | agentId | string | Agent identifier | | journalId | string | Optional journal entry ID | | donationFirstSum | number | First donation amount in recurring donations | | donationSumInCampaignCurrency | number | Donation amount in campaign’s currency | | splitAcrossMonths | number | Number of months to split donation across | | managedExternally | boolean | Whether the donation is managed outside the system | | cancelled | boolean | Whether the donation was cancelled | | updatedAt | number (timestamp) | Timestamp of last update | | updatedByUserId | string (UUID) | User ID who updated this record | | purchaseTitle | string | Title of the donation / payment | | customProperties | object | Custom donor properties (firstName, lastName, email, phone) | | createdAt | number (timestamp) | Record creation timestamp | | donatedOn | number (timestamp) | Date when donation occurred | | marketingCampaignId | string | Optional marketing campaign identifier | | secondaryContactId | string | Optional secondary contact reference | | status | string | Payment status (`requiresAction`, `completed`, etc.) | | scheduleDate | number | Scheduled date for donation (optional) | | nextBillingCycle | number | Next billing cycle timestamp (if recurring) | | failedReason | string | Reason for failed payment (if any) | | externalProviderSpecificFields | object | Fields specific to external payment providers | | cc4dig | string | Last 4 digits of credit card (if applicable) | | sum | number | Donation sum (duplicate of donationSum) | | currency | string | Donation currency (duplicate of donationCurrency) | | additionalRecurringMonths | number | Extra months for recurring donation | | additionalRecurringSum | number | Extra sum for recurring donation | | telephone | string | Ambassador phone number | | firstName | string | Ambassador first name | | lastName | string | Ambassador last name | | lang | string | Language code of ambassador (`he`, `en`) | | linkId | string | Unique link identifier for ambassador message | | customSecondaryProperties | object | Optional secondary custom properties | | contactProperties | object | Additional contact properties | | updateContactFieldsConfig | object | Configuration for updating contact fields | | futureCommitment | boolean | Whether donor committed to future donations | | internalComments | string | Internal comments regarding donation or ambassador | | complete | boolean | Whether donation processing is complete | | createReceipt | boolean | Whether to create a receipt automatically | | requiresTracking | boolean | Whether donation requires tracking | | createHistoricalTransactions | boolean | Whether historical transactions are generated | | firstSum | number | First payment sum (duplicate) | | paypalSubscriptionId | string | Optional PayPal subscription ID | | paypalOrderId | string | Optional PayPal order ID | | webhook | string | Webhook URL triggered by donation | | paymentCategory | string | Category of payment | | chargeDay | number | Day of month for recurring charge | | transactionResult | string | Result of transaction | | authNumber | string | Authorization number for payment | | transactionRef | string | Transaction reference ID | | backend | boolean | Whether action is triggered from backend | | source | string | Optional source information | | externalTransactionId | string | External payment ID | | externalSubscriptionId | string | External subscription ID | | externalReceiptCreated | boolean | Whether external receipt is already created | | skipTransactionCreation | boolean | Skip creating transaction in system | | masavBusinessName | string | Business name for MASAV payment (if any) | | importContactId | string | Imported contact ID (if any) | | splitAccountV2 | string | Account split information | | isPurchase | boolean | Marks if the payment is a purchase | | paymentMethodId | string (UUID) | Payment method ID | | receiptMethodId | string | Receipt method ID | | isFormSubmission | boolean | Whether this came from a form submission | | fullSum | number | Full sum of donation | | ambassadorId | string | Ambassador ID related to donation | | exchangeRateToUSD | number | Exchange rate to USD | | completed | boolean | Whether the donation process is completed | | items | array | Items associated with donation | | partition | string | Database partition key | | paymentMethodSource | string | Source of the payment method | | alertDate | number | Alert date for the action | | apiSource | string | Source API endpoint | | createdDate | number | Record creation date | | duplicateKey | string | Duplicate detection key | | firstNameLower | string | First name in lowercase | | hasActiveHok | boolean | Ambassador has active HOK / recurring donations | | hasDonated | boolean | Ambassador has donated before | | holding | boolean | Holding flag | | holdingTime | number | Duration of holding in ms | | ignoreDedupe | boolean | Whether deduplication should be ignored | | importId | string (UUID) | Import ID of the contact | | initialClosenessRating | number | Initial closeness rating | | isAmbassador | string | Whether the contact is an ambassador | | isContactImport | boolean | Imported as contact | | isPaymentImport | boolean | Imported as payment | | lastCallTime | number | Last call timestamp | | lastNameLower | string | Last name in lowercase | | mainAgent | string | Main agent responsible for ambassador | | nextAllowedCallTime | number | Next allowed call timestamp | | rating | number | Ambassador rating | | requestedNoCalls | boolean | Whether ambassador requested no calls | | segment | number | Segment ID | | skipEmailTelephoneCheck | boolean | Skip email/phone verification | | storedBillingMethod | array | Stored billing methods | | AMBASSADOR\_LINK\_HE | string (URL) | Ambassador link in Hebrew | | ambassadorLink | string | Ambassador unique link identifier | | AMBASSADOR\_TARGET\_LINK | string | Target link identifier | | AMBASSADOR\_STATS\_LINK | string (URL) | Link to ambassador stats page | | AMBASSADOR\_AMOUNT\_RAISED\_LINK | number | Total amount raised via ambassador | | AMBASSADOR\_PERCENT\_RAISED\_LINK | string | Percent of target raised | | AMBASSADOR\_PRECENT\_RAISED\_LINK | string | Duplicate percent raised field | | DONOR\_NAME\_TOKEN\_LINK | string | Donor display name token | | AMBASSADOR\_TARGET | string | Target campaign ID | | AMBASSADOR\_STATS | string (URL) | Ambassador stats page URL | | AMBASSADOR\_AMOUNT\_RAISED | number | Amount raised by ambassador | | AMBASSADOR\_PERCENT\_RAISED | string | Percent raised by ambassador | | DONOR\_NAME\_TOKEN | string | Donor display name |