Skip to content
English
  • There are no suggestions because the search field is empty.

Webhook Payload Structures

Understand how to parse and use webhook payloads.

This article explains the data structure for iDonate webhook events and how to access their properties. Understanding this structure is essential for parsing webhook data and building integrations.

All iDonate webhooks follow the same consistent top level structure, making them predictable and easy to work with. Only the type and payload properties change between events while everything else remains the same.

Standard Structure

{

  "id": "ace70024-c56c-11f0-a6e7-0242ac110011",
"type": "{event_trigger_type}", //e.g. "transaction_set.created"
  "created": "12-01-2025 09:26 PM",
"payload": {...}

}

Properties

  • id: Unique identifier for the webhook event.
  • type: The event trigger type (e.g., transaction_set.created).
  • created: Timestamp when the event occurred in UTC (UTC+0), formatted as MM-DD-YYYY HH:MM AM/PM
  • payload: Event specific data such as donor information, transactions, schedules, P2P data, and more.

Event Payloads

Event Type Reference

Technical Name

Display Name

Category

donor.contact_updated

Contact Updated

Donor

donor.cancel_organization_schedules

Donor Cancelled Schedules

Donor

event_registration.registered

Attendee Registered

Events

p2p_fundraiser.created

Fundraiser Created

Peer-to-Peer

p2p_fundraiser.milestone_reached

Milestone Reached

Peer-to-Peer

p2p_fundraiser.posted

Fundraiser Profile Update

Peer-to-Peer

p2p_fundraiser.updated

Fundraiser Updated

Peer-to-Peer

p2p_program.archived

Program Archived

Peer-to-Peer

p2p_program.created

Program Created

Peer-to-Peer

p2p_program.updated

Program Updated

Peer-to-Peer

recurring_donation_schedule.cancelled

Schedule Cancelled

Recurring Donations

recurring_donation_schedule.created

Schedule Created

Recurring Donations

recurring_donation_schedule.donor_update_requested

Donor Update Requested

Recurring Donations

recurring_donation_schedule.updated

Schedule Updated

Recurring Donations

transaction_set.created

Donation Created

Donations

transaction.updated

Donation Updated

Donations

 

Contact Updated Payload

{
  "id": "31d36248-d051-11f0-abae-0242ac110010",
  "type": "donor.contact_updated",
  "created": "09-23-2025 01:23 PM",
  "payload": {
    "id": "51e6795e-a07a-4631-99b9-5fd9e7ef4f3b",
    "contact": {
      "email": "rswanson@pawnee.gov",
      "phone": "5555555555",
      "title": "",
      "address": {
        "zip": "47998",
        "city": "Pawnee",
        "state": "IN",
        "title": null,
        "street": "100 State Street",
        "country": "US",
        "street2": "Suite 100",
        "country_code": "US",
        "country_name": "United States"
      },
      "created": "2020-11-05T06:57:01.962347+00:00",
      "updated": "2022-01-14T03:42:52.478931+00:00",
      "lastname": "Swanson",
      "timezone": "America/Chicago",
      "firstname": "Ron",
      "middlename": "Ulysses"
    },
    "contact_old": {
      "email": "rswanson@pawnee.gov",
      "phone": "5555555555",
      "title": "",
      "address": {
        "zip": "47998",
        "city": "Pawnee",
        "state": "IN",
        "title": null,
        "street": "100 State Street",
        "country": "US",
        "street2": "",
        "country_code": "US",
        "country_name": "United States"
      },
      "created": "2020-11-05T06:57:01.962347+00:00",
      "updated": "2022-01-14T03:42:52.478931+00:00",
      "lastname": "Swanson",
      "timezone": "America/Chicago",
      "firstname": "Ronald",
      "middlename": "Ulysses"
    },
    "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b"
  }
}

Donor Cancelled Schedules Payload

{
  "id": "d716e4c8-d8e0-11ef-a6dc-fad55d19bea0",
  "type": "donor.cancel_organization_schedules",
  "created": "01-22-2025 04:49 PM",
  "payload": {
    "donor": {
      "id": "d7eeccb9-0c28-4d5d-a5d8-02050b129a7d",
      "contact": {
        "email": "rswanson@pawnee.gov",
        "phone": "5555555555",
        "title": null,
        "address": {
          "zip": "47998",
          "city": "Pawnee",
          "state": "IN",
          "title": null,
          "street": "100 State Street",
          "country": "US",
          "street2": "Suite 100",
          "country_code": "US",
          "country_name": "United States"
        },
        "created": "2017-04-16T14:36:14.419617+00:00",
        "updated": "2020-03-22T16:49:28.348016+00:00",
        "lastname": "Swanson",
        "timezone": null,
        "firstname": "Ron",
        "middlename": null
      },
      "display_name": "Ron Swanson"
    },
    "schedules": null,
    "organization": {
      "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
      "name": "Pawnee City Hall"
    },
    "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b"
  }
}

Attendee Registered Payload

{
    "id": "6a540556-cefc-11f0-ab14-0242ac110013",
    "type": "event_registration.registered",
    "created": "12-01-2025 09:26 PM",
    "payload": {
        "id": "2a356112-32dd-49a0-9493-ddd44b9f726c",
        "order": {
            "id": "07ec737b-e300-477d-9ba0-3ceec518c8ef",
            "status": "EventOrderStatus.PROCESSING",
            "is_comp": false,
            "total_amount": "135.00",
            "transaction_id": null,
            "donation_amount": null,
            "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
            "organization_event_id": "a2b3ccbc-ba4a-4860-91ca-11ea2d3b0af7",
            "payment_transaction_id": "9e82v135-c154-41af-a13e-b8a1d5bbc5e7"
        },
        "status": "TicketInstanceStatus.ACTIVE",
        "guest_zip": "47998",
        "guest_city": "Pawnee",
        "promo_code": {
            "id": null,
            "code": null,
            "name": null,
            "description": null,
            "discount_flat": null,
            "discount_percent": null
        },
        "guest_email": "rswanson@pawnee.gov",
        "guest_phone": "5555555555",
        "guest_state": "IN",
        "guest_street": "100 State Street",
        "guest_company": "",
        "guest_country": "US",
        "guest_street2": "",
        "guest_last_name": "Swanson",
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "guest_first_name": "Ron",
        "guest_salutation": "",
        "survey_responses": [
            {
                "response": "Green",
                "survey_question": "Favorite Color"
            },
            {
                "response": "Dog",
                "survey_question": "Favorite Animal"
            }
        ],
        "ticket_definition": {
            "id": "f942861b-9d38-4211-9668-d8ee6de802c4",
            "name": "Lil Sebastian Ride Along",
            "price": "135.00",
            "description": "The ticket cost includes transportation, food for the night, and admission into all activities!",
            "fair_market_value": "0.00"
        },
        "organization_event": {
            "id": "a2b30cbc-ba4a-4860-91ca-11ea2d3b0af7",
            "name": "Lil Sebastian Extravaganza",
            "slug": "lil-seb-extravaganza",
            "web_url": "events.idonate.com/pawnee",
            "event_end": "2025-12-06T13:30:00+00:00",
            "venue_name": "Pawnee City Hall",
            "event_start": "2025-12-06T04:00:00+00:00",
            "organization": {
                "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
                "name": "Pawnee City Hall"
            },
            "venue_address": {
                "zip": "47998",
                "city": "Pawnee",
                "state": "IN",
                "title": null,
                "street": "100 State Street",
                "country": "US",
                "street2": "Suite 100",
                "country_code": "US",
                "country_name": "United States"
            },
            "event_metadata": {}
        }
    }
}

Fundraiser Created Payload

{
    "id": "1b02410e-cefa-11f0-8318-0242ac110013",
    "type": "p2p_fundraiser.created",
    "created": "12-01-2025 09:26 PM",
    "payload": {
        "id": "3b6a148a-0492-4cff-85e3-6d3a32b8440c",
        "goal": "500.00",
        "name": "Ron Swanson",
        "title": null,
        "status": "active",
        "created": "2025-12-01T21:10:03.186968+00:00",
        "program": {
            "id": "61ea9521-d029-4935-af92-91896c06f5d6",
            "goal": "25000.00",
            "name": "Pawnee Food Drive",
            "status": "active",
            "end_date": "2025-12-06T04:59:00+00:00",
            "start_date": "2025-10-14T17:13:35+00:00",
            "description": "Here is a test description",
            "organization": {
                "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
                "name": "Pawnee City Hall"
            },
            "include_donor_paid_fee": true
        },
        "created_by": "40afbc39-3d41-4a49-8548-d2890e7e41e2",
        "program_id": "65a9521-d029-4935-af92-91896c06f5d6",
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b"
    }
}

Milestone Reached Payload

{
    "id": "75e5ff0d-cf8a-11f0-91a4-0242ac110009",
    "type": "p2p_fundraiser.milestone_reached",
    "created": "12-01-2025 09:26 PM",
    "payload": {
        "milestone": "50.0%",
        "fundraiser": {
            "id": "199d6eb3-0571-471d-b751-48dda23629a9",
            "goal": "60000.00",
            "name": "Pawnee Food Bank",
            "title": "Pawnee Food Bank",
            "status": "active",
            "created": "2025-08-07T19:25:54.443621+00:00",
            "program": {
                "id": "8b67d585-cc8b-4ef8-a227-adf2b751511f",
                "goal": "120000.00",
                "name": "Giving Tuesday 2025",
                "status": "active",
                "end_date": "2026-07-01T19:57:00+00:00",
                "start_date": "2025-08-07T18:57:52+00:00",
                "description": "Here is a test description",
                "organization": {
                    "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
                    "name": "Pawnee City Hall"
                },
                "include_donor_paid_fee": true
            },
            "created_by": "626e7f64-8765-413b-a550-bcc7480bc083",
            "program_id": "8b67d585-fc8b-4ef8-a227-adf2b751511f"
        },
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b"
    }
}

Fundraiser Profile Update Payload

{
    "id": "8d2b2d6q-cefb-11f0-a1bd-0242ac110017",
    "type": "p2p_fundraiser.posted",
    "created": "12-01-2025 09:26 PM",
    "payload": {
        "id": "9cc48a53-3f3e-416a-a24a-9d2e1d62f660",
        "created": "2025-12-01T21:20:24.880802+00:00",
        "message": "Lil Sebastian is coming!",
        "fundraiser_id": "3b6a04sa-0492-4cff-85e3-3d3a32b8440c",
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b"
    }
}

Fundraiser Updated Payload

{
    "id": "daf48ad8-cf92-11f0-8c5f-0242ac110013",
    "type": "p2p_fundraiser.updated",
    "created": "12-01-2025 09:26 PM",
    "payload": {
        "id": "82478a93-81a2-46ef-b806-9f9b36116c72",
        "goal": "1.00",
        "name": "Ron Swanson",
        "title": "Pawnee Food Bank",
        "status": "active",
        "created": "2025-11-18T20:12:40.740086+00:00",
        "program": {
            "id": "58a05191-d2b9-4e77-9080-10e15aa94d89",
            "goal": "0.00",
            "name": "Pawnee Food Bank",
            "status": "active",
            "end_date": null,
            "start_date": "2025-11-17T20:08:24+00:00",
            "description": "This is a test description",
            "organization": {
                "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
                "name": "Pawnee City Hall"
            },
            "include_donor_paid_fee": true
        },
        "created_by": "7eb01657-1c6d-4cb0-8c78-04e7a7bc4354",
        "program_id": "58a05191-d2b9-4e77-9080-10e15aa94d89",
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b"
    }
}

Program Archived Payload

{
    "id": "2a6fa28c-c18d-22f0-8fe4-0242ac110018",
    "type": "p2p_program.archived",
    "created": "12-01-2025 09:26 PM",
    "payload": {
        "id": "7f2b646d-378f-47d8-a6a7-1ad0f45cfa74",
        "goal": "1000.00",
        "name": "Pawnee Food Bank",
        "status": "archived",
        "end_date": "2025-08-31T17:38:00+00:00",
        "start_date": "2024-12-03T17:38:00+00:00",
        "description": "This is a test description",
        "organization": {
            "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
            "name": "Pawnee City Hall"
        },
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "include_donor_paid_fee": false
    }
}

Program Created Payload

{
    "id": "ace70024-c56b-11f0-a6e7-0242ac110011",
    "type": "p2p_program.created",
    "created": "12-01-2025 09:26 PM",
    "payload": {
        "id": "942d4de7-91d8-4acb-8ee9-dfcff9257c1c",
        "goal": "15000.00",
        "name": "Pawnee Food Bank",
        "status": "draft",
        "end_date": "2026-02-01T06:00:00+00:00",
        "start_date": "2025-11-19T15:52:47+00:00",
        "description": "This is a test description",
        "organization": {
            "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
            "name": "Pawnee City Hall"
        },
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "include_donor_paid_fee": true
    }
}

Program Updated Payload

{
    "id": "ace70024-c56b-11f0-a6e7-0242ac110011",
    "type": "p2p_program.updated",
    "created": "12-01-2025 09:26 PM",
    "payload": {
        "id": "942d4de7-91d8-4acb-8ee9-dfcff9257c1c",
        "goal": "15000.00",
        "name": "Pawnee Food Bank",
        "status": "draft",
        "end_date": "2026-02-01T06:00:00+00:00",
        "start_date": "2025-11-19T15:52:47+00:00",
        "description": "This is a test description",
        "organization": {
            "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
            "name": "Pawnee City Hall"
        },
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "include_donor_paid_fee": true
    }
}

Schedule Cancelled Payload

{
  "id": "f5b0c9ce-cf9c-11f0-810a-0242ac110017",
  "type": "recurring_donation_schedule.cancelled",
  "created": "12-01-2025 09:26 PM",
  "payload": {
    "reason": "Schedule cancelled by donor",
    "schedule": {
      "id": "5dd680cb-6e8f-4715-ab2e-f98533b854c4",
      "donor": {
        "id": "11eacedc-5249-4477-9816-c17223f9dfb1",
        "contact": {
          "email": "rswanson@pawnee.gov",
          "phone": "5555555555",
          "title": "",
          "address": {
            "zip": "47998",
            "city": "Pawnee",
            "state": "IN",
            "title": null,
            "street": "100 State Street",
            "country": "US",
            "street2": "Suite 100",
            "country_code": "US",
            "country_name": "United States"
          },
          "created": "2020-11-05T06:57:01.962347+00:00",
          "updated": "2022-01-14T03:42:52.478931+00:00",
          "lastname": "Swanson",
          "timezone": "America/Chicago",
          "firstname": "Ron",
          "middlename": "Ulysses"
        },
        "display_name": "Ron Swanson"
      },
      "amount": "50.00",
      "expires": "2025-12-02T18:24:23.580952+00:00",
      "history": [
        {
          "user": "",
          "reason": "",
          "attribute": "Process Exception",
          "new_value": "Transaction not permitted to cardholder",
          "old_value": null,
          "updated_at": "2023-11-08T10:12:08.068646+00:00"
        },
        {
          "user": "",
          "reason": "",
          "attribute": "Process Exception",
          "new_value": "Transaction not permitted to cardholder",
          "old_value": null,
          "updated_at": "2023-11-15T12:09:41.279164+00:00"
        }
      ],
      "updated": "2025-12-02T18:24:23.583130+00:00",
      "is_company": false,
      "start_date": "2023-06-08T07:00:00+00:00",
      "company_name": null,
      "designations": [
        {
          "amount": "50.00",
          "designation": {
            "id": "4f9aea93-2cc1-4e94-a791-702f6911459d",
            "code": "food_bank",
            "title": "Food Bank",
            "fund_id": "food_bank"
          }
        }
      ],
      "next_payment": null,
      "organization": {
        "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "name": "Pawnee City Hall"
      },
      "currency_code": "USD",
      "customer_meta": {},
      "schedule_type": "monthly",
      "donor_paid_fee": null,
      "reference_code": null,
      "payment_gateway_id": "5d6dbe23-c254-4ef7-8b0d-debd1adeb7c5",
      "payment_gateway_name": "CardConnect: CardConnect"
    },
    "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b"
  }
}

Schedule Created Payload

{
  "id": "60c01fe0-cfae-11f0-8474-0242ac110017",
  "type": "recurring_donation_schedule.created",
  "created": "12-01-2025 09:26 PM",
  "payload": {
    "id": "36329e6e-229a-49af-87bc-907ed1e060be",
    "donor": {
      "id": "b02c5acc-97c9-4003-985b-7fe47510d90a",
      "contact": {
        "email": "rswanson@pawnee.gov",
        "phone": "5555555555",
        "title": "",
        "address": {
          "zip": "47998",
          "city": "Pawnee",
          "state": "IN",
          "title": null,
          "street": "100 State Street",
          "country": "US",
          "street2": "Suite 100",
          "country_code": "US",
          "country_name": "United States"
        },
        "created": "2020-11-05T06:57:01.962347+00:00",
        "updated": "2022-01-14T03:42:52.478931+00:00",
        "lastname": "Swanson",
        "timezone": "America/Chicago",
        "firstname": "Ron",
        "middlename": "Ulysses"
      },
      "display_name": "Ron Swanson"
    },
    "amount": "20.00",
    "expires": null,
    "history": [],
    "updated": "2025-12-02T18:40:30.242901+00:00",
    "is_company": false,
    "start_date": "2025-12-02T08:00:00+00:00",
    "company_name": null,
    "designations": [
      {
        "amount": "20.00",
        "designation": {
          "id": "2162acdc-88d7-43d9-95a2-485604e427f1",
          "code": "food_bank",
          "title": "Food Bank",
          "fund_id": "food_bank"
        }
      }
    ],
    "next_payment": "2026-01-02T08:00:00+00:00",
    "organization": {
      "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
      "name": "Pawnee City Hall"
    },
    "currency_code": "USD",
    "customer_meta": {},
    "schedule_type": "monthly",
    "donor_paid_fee": null,
    "reference_code": null,
    "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
    "payment_gateway_id": "6ec23030-545a-405d-b2fa-d7e0a640c82b",
    "payment_gateway_name": "CardConnect: CardConnect"
  }
}

Donor Update Requested Payload

{
    "id": "31d36248-d051-11f0-abae-0242ac110010",
    "type": "recurring_donation_schedule.donor_update_requested",
    "created": "09-23-2025 01:23 PM",
    "payload": {
        "id": "eeaff6bf-c0ea-4ac0-9a45-0b6ec0106368",
        "donor": {
            "id": "f79814e2-a638-4613-b1f5-4aabc348da7f",
            "contact": {
                "email": "rswanson@pawnee.gov",
                "phone": "5555555555",
                "title": "",
                "address": {
                    "zip": "47998",
                    "city": "Pawnee",
                    "state": "IN",
                    "title": null,
                    "street": "100 State Street",
                    "country": "US",
                    "street2": "Suite 100",
                    "country_code": "US",
                    "country_name": "United States"
                },
                "created": "2020-11-05T06:57:01.962347+00:00",
                "updated": "2022-01-14T03:42:52.478931+00:00",
                "lastname": "Swanson",
                "timezone": "America/Chicago",
                "firstname": "Ron",
                "middlename": "Ulysses"
            },
            "display_name": "Ron Swanson"
        },
        "amount": "26.20",
        "expires": null,
        "history": [
            {
                "user": "",
                "reason": "Donor Update",
                "attribute": "Payment Method",
                "new_value": "0cda93e1-3090-460c-8485-fe2f7be12292",
                "old_value": "73516b72-6c84-4396-be77-b4c506de61d4",
                "updated_at": "2021-04-05T18:37:27.536703+00:00"
            },
            {
                "user": "",
                "reason": "Donor Update",
                "attribute": "Payment Method",
                "new_value": "1c7fe10c-0774-4604-8470-235f652505c9",
                "old_value": "0cda93e1-3090-460c-8485-fe2f7be12292",
                "updated_at": "2021-04-05T18:38:50.212108+00:00"
            }
        ],
        "updated": "2024-11-27T09:11:30.850128+00:00",
        "is_company": false,
        "start_date": "2021-01-06T08:00:00+00:00",
        "company_name": null,
        "designations": [
            {
                "amount": "25.00",
                "designation": {
                    "id": "527fd92b-d600-4a89-9345-ff1c60648f37",
                    "code": "food_bank",
                    "title": "Food Bank",
                    "fund_id": "food_bank"
                }
            }
        ],
        "next_payment": "2024-12-04T08:00:00+00:00",
        "organization": {
            "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
            "name": "Pawnee City Hall"
        },
        "currency_code": "USD",
        "customer_meta": {},
        "schedule_type": "weekly",
        "donor_paid_fee": "1.20",
        "reference_code": null,
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "payment_gateway_id": "06a6b422-e7ec-4243-9b13-b68c80ec210d",
        "payment_gateway_name": "CardConnect: CardConnect"
    }
}

Schedule Updated Payload

{
    "id": "31d36248-d051-11f0-abae-0242ac110010",
    "type": "recurring_donation_schedule.updated",
    "created": "09-23-2025 01:23 PM",
    "payload": {
        "id": "a3ffa6c2-0956-486e-90be-4f8ebaf806cd",
        "donor": {
            "id": "ec311b44-bbbc-4fdf-8751-9331934cd8a1",
            "contact": {
                "email": "rswanson@pawnee.gov",
                "phone": "5555555555",
                "title": "",
                "address": {
                    "zip": "47998",
                    "city": "Pawnee",
                    "state": "IN",
                    "title": null,
                    "street": "100 State Street",
                    "country": "US",
                    "street2": "Suite 100",
                    "country_code": "US",
                    "country_name": "United States"
                },
                "created": "2020-11-05T06:57:01.962347+00:00",
                "updated": "2022-01-14T03:42:52.478931+00:00",
                "lastname": "Swanson",
                "timezone": "America/Chicago",
                "firstname": "Ron",
                "middlename": "Ulysses"
            },
            "display_name": "Ron Swanson"
        },
        "amount": "315.44",
        "expires": null,
        "history": [
            {
                "user": "",
                "reason": "",
                "attribute": "Schedule Type",
                "new_value": "monthly",
                "old_value": "weekly",
                "updated_at": "2024-12-05T15:59:59.086718+00:00"
            }
        ],
        "updated": "2024-12-05T15:58:18.694770+00:00",
        "is_company": false,
        "start_date": "2024-12-04T08:00:00+00:00",
        "company_name": null,
        "designations": [
            {
                "amount": "315.44",
                "designation": {
                    "id": "527fd92b-d600-4a89-9345-ff1c60648f37",
                    "code": "food_bank",
                    "title": "Food Bank",
                    "fund_id": "food_bank"
                }
            }
        ],
        "next_payment": "2024-12-12T08:00:00+00:00",
        "organization": {
            "id": "26e5630b-0a41-4d8c-989e-836a819de31b",
            "name": "Pawnee City Hall"
        },
        "currency_code": "USD",
        "customer_meta": {},
        "schedule_type": "weekly",
        "donor_paid_fee": "1.20",
        "reference_code": null,
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "payment_gateway_id": "06a6b422-e7ec-4243-9b13-b68c80ec210d",
        "payment_gateway_name": "CardConnect: CardConnect"
    }
}

Donation Created Payload

For more information on the differences between single and multi designation payloads and how to parse them, see Single vs Multi-Designation Donations.

Single Designation
{
    "id": "51e6795e-a07a-4631-99b9-5fd9e7ef4f6d",
    "type": "transaction_set.created",
    "created": "12-01-2025 09:26 PM",
    "payload": {
        "id": "b0e9b22d-7fde-4adf-ac13-813804756b53",
        "created": "2025-05-02T15:54:31.361239+00:00",
        "transactions": [
            {
                "id": "b0e9b22d-7fde-4adf-ac13-813804756b53",
                "utm": {
                    "term": "",
                    "medium": "",
                    "source": "",
                    "content": "",
                    "campaign": ""
                },
                "gift": null,
                "type": "cash",
                "embed": {
                    "id": "17f39f12-0643-4a7f-98ee-9cb95e3546a8",
                    "name": "Food Bank Giving Form"
                },
                "status": "complete",
                "address": {
                    "zip": "47998",
                    "city": "Pawnee",
                    "state": "IN",
                    "title": null,
                    "street": "100 State Street",
                    "country": "US",
                    "street2": "Suite 100",
                    "country_code": "US",
                    "country_name": "United States"
                },
                "contact": {
                    "email": "rswanson@pawnee.gov",
                    "phone": "5555555555",
                    "title": "",
                    "address": {
                        "zip": "47998",
                        "city": "Pawnee",
                        "state": "IN",
                        "title": null,
                        "street": "100 State Street",
                        "country": "US",
                        "street2": "Suite 100",
                        "country_code": "US",
                        "country_name": "United States"
                    },
                    "created": "2020-11-05T06:57:01.962347+00:00",
                    "updated": "2022-01-14T03:42:52.478931+00:00",
                    "lastname": "Swanson",
                    "timezone": "America/Chicago",
                    "firstname": "Ron",
                    "middlename": "Ulysses"
                },
                "created": "2025-05-02T15:54:31.361239+00:00",
                "subtype": "credit",
                "tribute": null,
                "advocate": null,
                "donor_id": "877eae13-464b-493d-af43-975e33b2f6bb",
                "card_type": "visa",
                "frequency": "Once",
                "hide_name": false,
                "vendor_id": null,
                "final_date": "2025-05-02T15:54:00+00:00",
                "gift_extra": "",
                "sale_price": null,
                "advocate_id": null,
                "campaign_id": "c9a68a57-19bb-4f50-b2e1-12f7defad243",
                "description": "Cash Donation: $10.60",
                "designation": {
                    "id": "04039903-ba9c-47ed-a152-545ffd539654",
                    "code": "food_bank",
                    "title": "Food Bank",
                    "fund_id": "food_bank"
                },
                "p2p_team_id": null,
                "schedule_id": null,
                "sms_keyword": null,
                "check_number": null,
                "company_name": "",
                "email_opt_in": false,
                "net_proceeds": 10.6,
                "advocate_name": null,
                "currency_code": "USD",
                "custom_note_1": null,
                "custom_note_2": null,
                "custom_note_3": null,
                "custom_note_4": null,
                "custom_note_5": null,
                "customer_meta": {},
                "p2p_team_name": null,
                "campaign_title": "Food Bank Campaign",
                "donor_paid_fee": 0.6,
                "p2p_program_id": null,
                "reference_code": null,
                "additional_info": null,
                "client_proceeds": 10.6,
                "expiration_year": 2029,
                "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
                "recurring_count": null,
                "advocacy_team_id": null,
                "designation_note": "",
                "expiration_month": 11,
                "last_four_digits": "1111",
                "p2p_program_name": null,
                "p2p_fundraiser_id": null,
                "advocacy_team_name": null,
                "payment_gateway_id": "4f6a6cbc-a148-4573-887b-6a0bfcc7bf84",
                "transaction_set_id": "b0e9b32d-7fde-4adf-ac13-813804756b53",
                "advocacy_program_id": null,
                "p2p_fundraiser_name": null,
                "external_tracking_id": "765b94e5-7e12-4790-a50d-3ec71628e22f",
                "p2p_fundraiser_title": null,
                "payment_gateway_name": "CardConnect: CardConnect",
                "advocacy_program_name": null,
                "organization_event_id": null,
                "payment_transaction_id": "765a04e5-7e12-4790-a50d-3ec71628e22f",
                "show_name_to_fundraiser": false,
                "corporate_matching_record": null
            }
        ],
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b"
    }
}
Multi Designation Payload
{
  "id": "cf46d82a-67e9-11f0-9346-0242ac110017",
  "type": "transaction_set.created",
  "created": "07-23-2025 01:23 PM",
  "payload": {
    "id": "5ec67d29-e05d-487c-a117-87403ea74747",
    "created": "2025-12-10T21:01:19.373161+00:00",
    "transactions": [
      {
        "id": "5ec67d39-e05d-487c-a117-87403ea74747",
        "utm": {
          "term": "",
          "medium": "",
          "source": "",
          "content": "",
          "campaign": ""
        },
        "gift": null,
        "type": "cash",
        "embed": {
          "id": "17f39f12-0643-4a7f-98ee-9cb95e3546a8",
          "name": "Food Bank Giving Form"
        },
        "status": "complete",
        "address": {
          "zip": "47998",
          "city": "Pawnee",
          "state": "IN",
          "title": null,
          "street": "100 State Street",
          "country": "US",
          "street2": "",
          "country_code": "US",
          "country_name": "United States"
        },
        "contact": {
          "email": "rswanson@pawnee.com",
          "phone": "",
          "title": "",
          "address": {
            "zip": "47998",
            "city": "Pawnee",
            "state": "IN",
            "title": null,
            "street": "100 State Street",
            "country": "US",
            "street2": "",
            "country_code": "US",
            "country_name": "United States"
          },
          "created": "2025-12-10T21:01:18.378946+00:00",
          "updated": "2025-12-10T21:01:18.544105+00:00",
          "lastname": "Swanson",
          "timezone": "America/New_York",
          "firstname": "Ron",
          "middlename": ""
        },
        "created": "2025-12-10T21:01:19.373161+00:00",
        "subtype": "credit",
        "tribute": {
          "honorees": [
            {
              "message": "tribute custom message",
              "lastname": "Knope",
              "firstname": "Leslie"
            }
          ],
          "from_name": "Ron Swanson",
          "recipient": {
            "email": "bwyatt@pawnee.com",
            "phone": null,
            "title": null,
            "address": {
              "zip": "47998",
              "city": "Pawnee",
              "state": "IN",
              "title": "Tribute Recipient Address",
              "street": "100 State St",
              "country": "US",
              "street2": "",
              "country_code": "US",
              "country_name": "United States"
            },
            "created": "2025-12-10T21:01:19.042249+00:00",
            "updated": "2025-12-10T21:01:19.042249+00:00",
            "lastname": "Wyatt",
            "timezone": null,
            "firstname": "Ben",
            "middlename": null
          },
          "send_card": false,
          "definition": {
            "id": "06dfd711-8813-4e5f-94a1-0d0955b75c60",
            "image_key": "[FALLBACK]",
            "image_url": "https://s3-us-west-2.amazonaws.com/idonate-embed/images/gift-fallback.png",
            "description": "In Honor Of",
            "is_disabled": false,
            "remove_tribute_send": false,
            "recipient_email_required": false,
            "recipient_address_required": false
          },
          "include_amount": false
        },
        "advocate": null,
        "donor_id": "3ea274a5-eb5e-4418-bebe-6a2a25ab0735",
        "card_type": "visa",
        "frequency": "Once",
        "hide_name": false,
        "vendor_id": null,
        "final_date": "2025-12-10T21:01:00+00:00",
        "gift_extra": "",
        "sale_price": null,
        "advocate_id": null,
        "campaign_id": "c9a68a57-19bb-4f50-b2e1-12f7defad243",
        "description": "Cash Multi-Donation [0/2]: $2.85/$102.85",
        "designation": {
          "id": null,
          "code": null,
          "title": null,
          "fund_id": null
        },
        "p2p_team_id": null,
        "schedule_id": null,
        "sms_keyword": null,
        "check_number": null,
        "company_name": "",
        "email_opt_in": false,
        "net_proceeds": 102.85,
        "advocate_name": null,
        "currency_code": "USD",
        "custom_note_1": null,
        "custom_note_2": null,
        "custom_note_3": null,
        "custom_note_4": null,
        "custom_note_5": null,
        "customer_meta": {
          "single_choice": "Choice 1"
        },
        "p2p_team_name": null,
        "campaign_title": "Food Bank Campaign",
        "donor_paid_fee": 2.85,
        "p2p_program_id": null,
        "reference_code": null,
        "additional_info": null,
        "client_proceeds": 2.85,
        "expiration_year": 2029,
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "recurring_count": null,
        "advocacy_team_id": null,
        "designation_note": "",
        "expiration_month": 11,
        "last_four_digits": "1111",
        "p2p_program_name": null,
        "p2p_fundraiser_id": null,
        "advocacy_team_name": null,
        "payment_gateway_id": "4f6a2fbc-a148-4573-887b-6a0bfcc7bf84",
        "transaction_set_id": "5ec62d39-e05d-487c-a117-87403ea74747",
        "advocacy_program_id": null,
        "p2p_fundraiser_name": null,
        "external_tracking_id": "e62f5dc9-3732-4cde-a271-527965aa293b",
        "p2p_fundraiser_title": null,
        "payment_gateway_name": "CardConnect: CardConnect",
        "advocacy_program_name": null,
        "organization_event_id": null,
        "payment_transaction_id": "e6df2dc9-3732-4cde-a271-527965aa293b",
        "show_name_to_fundraiser": false,
        "corporate_matching_record": null
      },
      {
        "id": "72965ace-0618-4e69-81e3-f6adaf98c292",
        "utm": {
          "term": null,
          "medium": null,
          "source": null,
          "content": null,
          "campaign": null
        },
        "gift": null,
        "type": "cash",
        "embed": null,
        "status": "complete",
        "address": {
          "zip": "47998",
          "city": "Pawnee",
          "state": "IN",
          "title": null,
          "street": "100 State Street",
          "country": "US",
          "street2": "",
          "country_code": "US",
          "country_name": "United States"
        },
        "contact": {
          "email": "rswanson@pawnee.com",
          "phone": "",
          "title": "",
          "address": {
            "zip": "47998",
            "city": "Pawnee",
            "state": "IN",
            "title": null,
            "street": "100 State Street",
            "country": "US",
            "street2": "",
            "country_code": "US",
            "country_name": "United States"
          },
          "created": "2025-12-10T21:01:18.378946+00:00",
          "updated": "2025-12-10T21:01:18.544105+00:00",
          "lastname": "Swanson",
          "timezone": "America/New_York",
          "firstname": "Ron",
          "middlename": ""
        },
        "created": "2025-12-10T21:01:19.383161+00:00",
        "subtype": "credit",
        "tribute": null,
        "advocate": null,
        "donor_id": "3ea274a5-eb5e-4418-bebe-6a2a25ab0735",
        "card_type": null,
        "frequency": null,
        "hide_name": null,
        "vendor_id": null,
        "final_date": null,
        "gift_extra": "",
        "sale_price": null,
        "advocate_id": null,
        "campaign_id": "c9a68a57-19bb-4f50-b2e1-12f7defad243",
        "description": "Cash Multi-Donation [1/2]: $50.00",
        "designation": {
          "id": "04039903-ba9c-47ed-a152-545ffd539654",
          "code": "food_bank",
          "title": "Food Bank",
          "fund_id": "food_bank"
        },
        "p2p_team_id": null,
        "schedule_id": null,
        "sms_keyword": null,
        "check_number": null,
        "company_name": null,
        "email_opt_in": null,
        "net_proceeds": 0.0,
        "advocate_name": null,
        "currency_code": "USD",
        "custom_note_1": null,
        "custom_note_2": null,
        "custom_note_3": null,
        "custom_note_4": null,
        "custom_note_5": null,
        "customer_meta": {},
        "p2p_team_name": null,
        "campaign_title": "Food Bank Campaign",
        "donor_paid_fee": null,
        "p2p_program_id": null,
        "reference_code": null,
        "additional_info": null,
        "client_proceeds": 50.0,
        "expiration_year": null,
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "recurring_count": null,
        "advocacy_team_id": null,
        "designation_note": "",
        "expiration_month": null,
        "last_four_digits": null,
        "p2p_program_name": null,
        "p2p_fundraiser_id": null,
        "advocacy_team_name": null,
        "payment_gateway_id": null,
        "transaction_set_id": "5ec67d39-e05d-487c-a117-87403ea74747",
        "advocacy_program_id": null,
        "p2p_fundraiser_name": null,
        "external_tracking_id": "e6df5dc9-3732-4cde-a271-527965aa293b",
        "p2p_fundraiser_title": null,
        "payment_gateway_name": null,
        "advocacy_program_name": null,
        "organization_event_id": null,
        "payment_transaction_id": null,
        "show_name_to_fundraiser": null,
        "corporate_matching_record": null
      },
      {
        "id": "8c7f5d58-96fe-4ae1-aa98-eabfc4805b2d",
        "utm": {
          "term": null,
          "medium": null,
          "source": null,
          "content": null,
          "campaign": null
        },
        "gift": null,
        "type": "cash",
        "embed": null,
        "status": "complete",
        "address": {
          "zip": "47998",
          "city": "Pawnee",
          "state": "IN",
          "title": null,
          "street": "100 State Street",
          "country": "US",
          "street2": "",
          "country_code": "US",
          "country_name": "United States"
        },
        "contact": {
          "email": "rswanson@pawnee.com",
          "phone": "",
          "title": "",
          "address": {
            "zip": "47998",
            "city": "Pawnee",
            "state": "IN",
            "title": null,
            "street": "100 State Street",
            "country": "US",
            "street2": "",
            "country_code": "US",
            "country_name": "United States"
          },
          "created": "2025-12-10T21:01:18.378946+00:00",
          "updated": "2025-12-10T21:01:18.544105+00:00",
          "lastname": "Swanson",
          "timezone": "America/New_York",
          "firstname": "Ron",
          "middlename": ""
        },
        "created": "2025-12-10T21:01:19.393161+00:00",
        "subtype": "credit",
        "tribute": null,
        "advocate": null,
        "donor_id": "3ea274a5-eb5e-4418-bebe-6a2a25ab0735",
        "card_type": null,
        "frequency": null,
        "hide_name": null,
        "vendor_id": null,
        "final_date": null,
        "gift_extra": "",
        "sale_price": null,
        "advocate_id": null,
        "campaign_id": "c9a68a57-19bb-4f50-b2e1-12f7defad243",
        "description": "Cash Multi-Donation [2/2]: $50.00",
        "designation": {
          "id": "e1f750c4-77a3-45b5-817a-5ad0d156ea7e",
          "code": "general_fund",
          "title": "General Fund",
          "fund_id": "general_fund"
        },
        "p2p_team_id": null,
        "schedule_id": null,
        "sms_keyword": null,
        "check_number": null,
        "company_name": null,
        "email_opt_in": null,
        "net_proceeds": 0.0,
        "advocate_name": null,
        "currency_code": "USD",
        "custom_note_1": null,
        "custom_note_2": null,
        "custom_note_3": null,
        "custom_note_4": null,
        "custom_note_5": null,
        "customer_meta": {},
        "p2p_team_name": null,
        "campaign_title": "Food Bank Campaign",
        "donor_paid_fee": null,
        "p2p_program_id": null,
        "reference_code": null,
        "additional_info": null,
        "client_proceeds": 50.0,
        "expiration_year": null,
        "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b",
        "recurring_count": null,
        "advocacy_team_id": null,
        "designation_note": "",
        "expiration_month": null,
        "last_four_digits": null,
        "p2p_program_name": null,
        "p2p_fundraiser_id": null,
        "advocacy_team_name": null,
        "payment_gateway_id": null,
        "transaction_set_id": "5ec67d39-e05d-487c-a117-87403ea74747",
        "advocacy_program_id": null,
        "p2p_fundraiser_name": null,
        "external_tracking_id": "e6df5dc9-3732-4cde-a271-527965aa293b",
        "p2p_fundraiser_title": null,
        "payment_gateway_name": null,
        "advocacy_program_name": null,
        "organization_event_id": null,
        "payment_transaction_id": null,
        "show_name_to_fundraiser": null,
        "corporate_matching_record": null
      }
    ],
    "organization_id": "26e5630b-0a41-4d8c-989e-836a819de31b"
  }
}

Donation Updated Payload

{
    "id": "fff1bdde-ca0a-11f0-bd24-0242ac11ff17",
    "type": "transaction.updated",
    "created": "02-23-2026 09:23 AM",
    "payload": {
        "id": "369a71f2-0a33-4792-8e6f-58cf1524310d",
        "utm": {
            "term": "",
            "medium": "",
            "source": "",
            "content": "",
            "campaign": ""
        },
        "gift": null,
        "type": "cash",
        "embed": {
            "id": "3b7d92cd-44da-4d23-9f5f-a7218f510c20",
            "name": "Food Bank Giving Form"
        },
        "status": "complete",
        "address": {
            "zip": "47998",
            "city": "Pawnee",
            "state": "IN",
            "title": null,
            "street": "100 State Street",
            "country": "US",
            "street2": "",
            "country_code": "US",
            "country_name": "United States"
        },
        "contact": {
            "email": "rswanson@pawnee.com",
            "phone": "",
            "title": "",
            "address": {
                "zip": "47998",
                "city": "Pawnee",
                "state": "IN",
                "title": null,
                "street": "100 State Street",
                "country": "US",
                "street2": "",
                "country_code": "US",
                "country_name": "United States"
            }
        },
        "created": "2026-02-20T21:19:22.704806+00:00",
        "subtype": "credit",
        "tribute": null,
        "advocate": null,
        "donor_id": "0004aecf-ab93-4cfc-b6ad-00b8089a80a9",
        "card_type": "visa",
        "frequency": "Once",
        "hide_name": false,
        "vendor_id": null,
        "final_date": "2026-02-23T21:19:00+00:00",
        "gift_extra": "",
        "sale_price": null,
        "advocate_id": null,
        "campaign_id": "3f246608-4e8d-4f01-a124-6e4e1a6e2b8d",
        "description": "Cash Donation: $50.00",
        "designation": {
            "id": "04d163e3-683d-4e43-bd79-1e05e86a5b41",
            "code": "test-designation",
            "title": "Test",
            "fund_id": "test-designation"
        },
        "p2p_team_id": null,
        "schedule_id": null,
        "sms_keyword": null,
        "check_number": null,
        "company_name": "iDonate",
        "email_opt_in": false,
        "net_proceeds": 50.0,
        "advocate_name": null,
        "currency_code": "USD",
        "custom_note_1": null,
        "custom_note_2": null,
        "custom_note_3": null,
        "custom_note_4": null,
        "custom_note_5": null,
        "customer_meta": {},
        "p2p_team_name": null,
        "campaign_title": "iDonate Test Campaign",
        "donor_paid_fee": null,
        "p2p_program_id": null,
        "reference_code": "reference code",
        "additional_info": null,
        "client_proceeds": 50.0,
        "expiration_year": 29,
        "organization_id": "00000000-0000-0000-0000-000000000000",
        "recurring_count": null,
        "advocacy_team_id": null,
        "designation_note": "",
        "expiration_month": 11,
        "last_four_digits": "1111",
        "p2p_program_name": null,
        "p2p_fundraiser_id": null,
        "advocacy_team_name": null,
        "payment_gateway_id": "90d38d7f-d334-4cb1-9c76-b6a8e286097b",
        "transaction_set_id": "369a71f2-0a33-4792-8e6f-58cf1524310d",
        "advocacy_program_id": null,
        "p2p_fundraiser_name": null,
        "external_tracking_id": "051639758762",
        "p2p_fundraiser_title": null,
        "payment_gateway_name": "CardConnect: CardConnect",
        "advocacy_program_name": null,
        "organization_event_id": null,
        "payment_transaction_id": "c89d3b4e-7afd-4bbd-90bd-9f8a04d67c39",
        "show_name_to_fundraiser": false,
        "corporate_matching_record": null
    }
}