Webhooks enable your applications to be notified instantly and execute actions accordingly whenever an event occurs in your Donorbox account. This feature is part of the "Zapier & API" addon.
How to add a custom webhook endpoint URL?
To make use of the custom webhooks feature, you need to enable the add-on "API & Zapier integration" or upgrade to the "Premium" plan
To enable the add-on:
Login to your Donorbox account, click Add-ons in the left sidebar > click API & Zapier Integration, and click Activate Zapier Integration.
To upgrade to the premium plan:
Login to your Donorbox account, click on the "Upgrade" button on the bottom of the left sidebar
1. Once you have the add-on enabled, you can add the custom webhook URL on the "API & Zapier Integration" page. When there are no custom webhook URLs added yet, you will see the option to add one, like in the below screenshot.
2. Clicking on the button will display the "Add Custom Webhook" form
3. Enter the endpoint URL and choose one or more events that should trigger a notification to the endpoint URL, then click "Add Endpoint" to submit the form.
4. Choose the version v1 or v2. Payload format sent to the endpoint URL will differ based on this version.
5. Once the form is successfully submitted, you will see the endpoint URL successfully added.
6. You can add more endpoint URLs by clicking on the "Add new endpoint URL" button.
7. You can enable/disable notifications to the endpoint URL by toggling the switch shown in the above screenshot.
Webhook Events
Donorbox provides the following list of webhook events. A post request is submitted to the specified endpoint URL with a JSON payload when the event occurs in your Donorbox account.
donation.created
This event is triggered when a new donation is received.
Sample payload for version v1
[
{
"action": "new",
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": true,
"first_recurring_donation": true,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
]
"plan_id": 12345,
"interval": "1 M"
}
]
Sample payload for version v2
{
"event_id": 7156,
"event_name": "donation.created",
"created_at": "2025-06-28T12:15:28Z",
"donation": {
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": true,
"first_recurring_donation": true,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
],
"plan_id": 12345,
"interval": "1 M"
}
}
Note: As shown in the above sample payloads, "plan_id" and "interval" attributes will be present only if the donation is a recurring donation. The interval "1 M" indicates its a monthly recurring donation. It can have one of the following values:
"1 W" => Weekly
"2 W" => Biweekly
"1 M" => Monthly
"3 M" => Qurterly
"1 Y" => Annual
donation.updated
This event is triggered when an existing donation is modified.
Sample payload for version v1
[
{
"action": "update",
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": false,
"first_recurring_donation": false,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
]
}
]
Sample payload for version v2
{
"event_id": 7157,
"event_name": "donation.updated",
"created_at": "2025-06-28T12:15:28Z",
"donation": {
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": false,
"first_recurring_donation": false,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
]
}
}
donation.chargeback_created
This event is triggered when a chargeback is created for the donation on the payment gateway.
Sample payload for version v1
[
{
"action": "donation.chargeback_created",
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": false,
"first_recurring_donation": false,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
]
}
]
Sample payload for version v2
{
"event_id": 8157,
"event_name": "donation.chargeback_created",
"created_at": "2025-06-28T12:15:28Z",
"donation": {
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": false,
"first_recurring_donation": false,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
]
}
}
donation.chargeback_won
This event is triggered when a chargeback created for the donation on the payment gateway is won.
Sample payload for version v1
[
{
"action": "donation.chargeback_won",
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": false,
"first_recurring_donation": false,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
]
}
]
Sample payload for version v2
{
"event_id": 8157,
"event_name": "donation.chargeback_won",
"created_at": "2025-06-28T12:15:28Z",
"donation": {
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": false,
"first_recurring_donation": false,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
]
}
}
donation.chargeback_lost
This event is triggered when a chargeback created for the donation on the payment gateway is lost.
Sample payload for version v1
[
{
"action": "donation.chargeback_lost",
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": false,
"first_recurring_donation": false,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
]
}
]
Sample payload for version v2
{
"event_id": 8157,
"event_name": "donation.chargeback_lost",
"created_at": "2025-06-28T12:15:28Z",
"donation": {
"campaign": {
"id": 1,
"name": "Donorbox Campaign"
},
"donor": {
"id": 59,
"name": "John Doe",
"first_name": "John",
"last_name": "Doe",
"email": "johndoeemail@hotmail.com",
"address":"123 6th St.",
"address_line_2":"Lakeside Road",
"city":"Melbourne",
"state":"FL",
"zip_code": "32904",
"country":"US",
"employer":null,
"occupation":null
},
"amount": "100.0",
"formatted_amount": "$100",
"converted_amount": "100.0",
"formatted_converted_amount": "$100",
"recurring": false,
"first_recurring_donation": false,
"amount_refunded": "0.0",
"formatted_amount_refunded": "$0",
"stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
"id": 1,
"status": "paid",
"donation_type": "stripe",
"donation_date": "2017-12-21T17:54:13.432Z",
"anonymous_donation": false,
"gift_aid": false,
"designation": "Designed Cause",
"join_mailing_list": false,
"comment": "thanks",
"donating_company": null,
"currency": "USD",
"converted_currency": "USD",
"utm_campaign": "google_ads",
"utm_source": "Adwords",
"utm_medium": "cpc",
"utm_term": "nonprofit fundraising",
"utm_content": "np1",
"processing_fee": 0.59,
"formatted_processing_fee": "$0.59",
"address": "123 6th St.",
"address_line_2": "Lakeside Road",
"city": "Melbourne",
"state": "FL",
"zip_code": "32904",
"country": "US",
"employer": null,
"occupation": null,
"questions": [
{
"question_type": "radiobutton",
"question": "Would you like to volunteer?",
"answer": "Yes"
},
{
"question_type": "text",
"question": "Why are you donating",
"answer": "I would like to help"
},
{
"question_type": "check",
"question": "First/Last Name is correct?",
"answer": true
},
{
"question_type": "dropdown",
"question": "Would you like to showcase your donation",
"answer": "Yes"
}
]
}
}
donor.created
This event is triggered when a new donor record is created.
Sample payload for version v1
[
{
"action": "new",
"id":35,
"created_at":"2017-11-20T14:01:35.597Z",
"updated_at":"2017-11-28T21:49:25.127Z",
"first_name":"John",
"last_name":"Doe",
"email":"johndoe@email.com",
"phone":"123456789",
"address":"123 6th St.",
"city":"Melbourne",
"state":"FL",
"zip_code":"32904",
"country":"USA",
"employer":null,
"occupation":null,
"comment":null,
"donations_count":2,
"last_donation_at":"2017-11-28T21:48:51.260Z",
"total":[
{
"currency":"usd",
"value":100.0
}
]
}
]
Sample payload for version v2
{
"event_id": 7159,
"event_name": "donor.created",
"created_at": "2025-06-28T12:15:28Z",
"donor": {
"id":35,
"created_at":"2017-11-20T14:01:35.597Z",
"updated_at":"2017-11-28T21:49:25.127Z",
"first_name":"John",
"last_name":"Doe",
"email":"johndoe@email.com",
"phone":"123456789",
"address":"123 6th St.",
"city":"Melbourne",
"state":"FL",
"zip_code":"32904",
"country":"USA",
"employer":null,
"occupation":null,
"comment":null,
"donations_count":2,
"last_donation_at":"2017-11-28T21:48:51.260Z",
"total":[
{
"currency":"usd",
"value":100.0
}
]
}
}
donor.updated
This event is triggered when an existing donor record is updated.
Sample payload for version v1
[
{
"action": "update",
"id":35,
"created_at":"2017-11-20T14:01:35.597Z",
"updated_at":"2017-11-28T21:49:25.127Z",
"first_name":"John",
"last_name":"Doe",
"email":"johndoe@email.com",
"phone":"123456789",
"address":"123 6th St.",
"city":"Melbourne",
"state":"FL",
"zip_code":"32904",
"country":"USA",
"employer":null,
"occupation":null,
"comment":null,
"donations_count":2,
"last_donation_at":"2017-11-28T21:48:51.260Z",
"total":[
{
"currency":"usd",
"value":100.0
}
]
}
]
Sample payload for version v2
{
"event_id": 7160,
"event_name": "donor.updated",
"created_at": "2025-06-28T12:15:28Z",
"donor": {
"id":35,
"created_at":"2017-11-20T14:01:35.597Z",
"updated_at":"2017-11-28T21:49:25.127Z",
"first_name":"John",
"last_name":"Doe",
"email":"johndoe@email.com",
"phone":"123456789",
"address":"123 6th St.",
"city":"Melbourne",
"state":"FL",
"zip_code":"32904",
"country":"USA",
"employer":null,
"occupation":null,
"comment":null,
"donations_count":2,
"last_donation_at":"2017-11-28T21:48:51.260Z",
"total":[
{
"currency":"usd",
"value":100.0
}
]
}
}
campaign.created
This event is triggered when a new campaign is created.
Sample payload for version v1
[
{
"action": "new",
"id":1,
"name":"Help feeding homeless children",
"slug":"help-feeding-homeless-children",
"currency":"usd",
"created_at":"2017-10-20T22:30:55.620Z",
"updated_at":"2017-10-20T22:30:55.620Z",
"goal_amt":"10000.0",
"formatted_goal_amount":"$1,0000",
"total_raised":"2000.0",
"formatted_total_raised":"$2000",
"donations_count":66
}
]
Sample payload for version v2
{
"event_id": 7161,
"event_name": "campaign.created",
"created_at": "2025-06-28T12:15:28Z",
"campaign": {
"id":1,
"name":"Help feeding homeless children",
"slug":"help-feeding-homeless-children",
"currency":"usd",
"created_at":"2017-10-20T22:30:55.620Z",
"updated_at":"2017-10-20T22:30:55.620Z",
"goal_amt":"10000.0",
"formatted_goal_amount":"$1,0000",
"total_raised":"2000.0",
"formatted_total_raised":"$2000",
"donations_count":66
}
}
campaign.updated
This event is triggered when an existing campaign is updated.
Sample payload for version v1
[
{
"action": "update",
"id":1,
"name":"Help feeding homeless children",
"slug":"help-feeding-homeless-children",
"currency":"usd",
"created_at":"2017-10-20T22:30:55.620Z",
"updated_at":"2017-10-20T22:30:55.620Z",
"goal_amt":"10000.0",
"formatted_goal_amount":"$1,0000",
"total_raised":"2000.0",
"formatted_total_raised":"$2000",
"donations_count":66
}
]
Sample payload for version v2
{
"event_id": 7161,
"event_name": "campaign.updated",
"created_at": "2025-06-28T12:15:28Z",
"campaign": {
"id":1,
"name":"Help feeding homeless children",
"slug":"help-feeding-homeless-children",
"currency":"usd",
"created_at":"2017-10-20T22:30:55.620Z",
"updated_at":"2017-10-20T22:30:55.620Z",
"goal_amt":"10000.0",
"formatted_goal_amount":"$1,0000",
"total_raised":"2000.0",
"formatted_total_raised":"$2000",
"donations_count":66
}
}
plan.created
This event is triggered when a new recurring plan is created.
Sample payload for version v1
[
{
"action": "new",
"id": 168,
"campaign": {
"id": 61,
"name": "Save the jungle campaign"
},
"donor": {
"id": 384,
"name": "Bruce Waine",
"first_name": "Bruce",
"last_name": "Waine",
"email": "bruce@email.com",
"phone": "8038984624",
"address": "123 6th St.",
"city":"Melbourne",
"state":"FL",
"zip_code":"32904",
"country": "USA",
"employer": "Waine Industries",
"occupation": "CEO"
},
"type": "monthly",
"amount": "10.0",
"formatted_amount": "$10",
"payment_method": "Stripe",
"started_at": "2018-07-25",
"last_donation_date": "2018-07-25T05:00:00.000Z",
"next_donation_date": "2018-08-25",
"status": "active"
}
]
Sample payload for version v2
{
"event_id": 7162,
"event_name": "plan.created",
"created_at": "2025-06-28T12:15:28Z",
"plan": {
"id": 168,
"campaign": {
"id": 61,
"name": "Save the jungle campaign"
},
"donor": {
"id": 384,
"name": "Bruce Waine",
"first_name": "Bruce",
"last_name": "Waine",
"email": "bruce@email.com",
"phone": "8038984624",
"address": "123 6th St.",
"city":"Melbourne",
"state":"FL",
"zip_code":"32904",
"country": "USA",
"employer": "Waine Industries",
"occupation": "CEO"
},
"type": "monthly",
"amount": "10.0",
"formatted_amount": "$10",
"payment_method": "Stripe",
"started_at": "2018-07-25",
"last_donation_date": "2018-07-25T05:00:00.000Z",
"next_donation_date": "2018-08-25",
"status": "active"
}
}
plan.updated
This event is triggered when an existing recurring plan is updated.
Sample payload for version v1
[
{
"action": "update",
"id": 168,
"campaign": {
"id": 61,
"name": "Save the jungle campaign"
},
"donor": {
"id": 384,
"name": "Bruce Waine",
"first_name": "Bruce",
"last_name": "Waine",
"email": "bruce@email.com",
"phone": "8038984624",
"address": "123 6th St.",
"city":"Melbourne",
"state":"FL",
"zip_code":"32904",
"country": "USA",
"employer": "Waine Industries",
"occupation": "CEO"
},
"type": "monthly",
"amount": "10.0",
"formatted_amount": "$10",
"payment_method": "Stripe",
"started_at": "2018-07-25",
"last_donation_date": "2018-07-25T05:00:00.000Z",
"next_donation_date": "2018-08-25",
"status": "active"
}
]
Sample payload for version v2
{
"event_id": 7163,
"event_name": "plan.updated",
"created_at": "2025-06-28T12:15:28Z",
"plan": {
"id": 168,
"campaign": {
"id": 61,
"name": "Save the jungle campaign"
},
"donor": {
"id": 384,
"name": "Bruce Waine",
"first_name": "Bruce",
"last_name": "Waine",
"email": "bruce@email.com",
"phone": "8038984624",
"address": "123 6th St.",
"city":"Melbourne",
"state":"FL",
"zip_code":"32904",
"country": "USA",
"employer": "Waine Industries",
"occupation": "CEO"
},
"type": "monthly",
"amount": "10.0",
"formatted_amount": "$10",
"payment_method": "Stripe",
"started_at": "2018-07-25",
"last_donation_date": "2018-07-25T05:00:00.000Z",
"next_donation_date": "2018-08-25",
"status": "active"
}
}
purchase.created
This event is triggered when a purchase record is created for event tickets.
Sample payload for version v1
[
{
"action": "new",
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
]
Sample payload for version v2
{
"event_id": 7164,
"event_name": "purchase.created",
"created_at": "2025-06-28T12:15:28Z",
"purchase": {
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
}
purchase.updated
This event is triggered when an existing purchase record is updated
Sample payload for version v1
[
{
"action": "update",
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
]
Sample payload for version v2
{
"event_id": 7165,
"event_name": "purchase.created",
"created_at": "2025-06-28T12:15:28Z",
"purchase": {
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
}
purchase.chargeback_created
This event is triggered when a chargeback is created for the purchase on the payment gateway.
Sample payload for version v1
[
{
"action": "purchase.chargeback_created",
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
]
Sample payload for version v2
{
"event_id": 8164,
"event_name": "purchase.chargeback_created",
"created_at": "2025-06-28T12:15:28Z",
"purchase": {
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
}
purchase.chargeback_won
This event is triggered when a chargeback created for the purchase on the payment gateway is won.
Sample payload for version v1
[
{
"action": "purchase.chargeback_won",
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
]
Sample payload for version v2
{
"event_id": 8164,
"event_name": "purchase.chargeback_won",
"created_at": "2025-06-28T12:15:28Z",
"purchase": {
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
}
purchase.chargeback_lost
This event is triggered when a chargeback created for the purchase on the payment gateway is lost.
Sample payload for version v1
[
{
"action": "purchase.chargeback_lost",
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
]
Sample payload for version v2
{
"event_id": 8164,
"event_name": "purchase.chargeback_lost",
"created_at": "2025-06-28T12:15:28Z",
"purchase": {
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "12301",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null,
"event": {
"id": 2,
"name": "Event"
},
"tickets": [
{
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
},
{
"id": 7,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
}
}
]
}
}
ticket.created
This event is triggered when a ticket created is created
Sample payload for version v1
[
{
"action": "new",
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
},
"event": {
"id": 2,
"name": "Event"
},
"transaction": {
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "123012",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null
}
}
]
Sample payload for version v2
{
"event_id": 7166,
"event_name": "ticket.created",
"created_at": "2025-06-28T12:15:28Z",
"purchase": {
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
},
"event": {
"id": 2,
"name": "Event"
},
"transaction": {
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "123012",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null
}
}
}
ticket.updated
This event is triggered when an existing ticket is updated
Sample payload for version v1
[
{
"action": "update",
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
},
"event": {
"id": 2,
"name": "Event"
},
"transaction": {
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "123012",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null
}
}
]
Sample payload for version v2
{
"event_id": 7167,
"event_name": "ticket.updated",
"created_at": "2025-06-28T12:15:28Z",
"purchase": {
"id": 6,
"currency": "USD",
"free_ticket": false,
"price": 10.0,
"price_formatted": "$10",
"ticket_type": {
"id": 1,
"name": "Ticket",
"fair_market_value": 0.0,
"fair_market_value_formatted": null,
"tax_deductible_amount": 0.0,
"tax_deductible_amount_formatted": null,
"tax_amount": 0.0,
"tax_amount_formatted": null
},
"event": {
"id": 2,
"name": "Event"
},
"transaction": {
"id": 6,
"currency": "USD",
"status": "paid",
"city": "New York",
"state": "New York",
"country": "US",
"zip": "123012",
"first_name": "John",
"last_name": "Doe",
"donation_id": null,
"stripe_charge_id": "ch_3RTuyJ5eA6TyHo4FN95wSEptCx",
"full_name": "John Doe",
"address": "47 W 13th St, New York",
"phone": "1234567890",
"email": "johndoe@sample.com",
"supporter_id": 26275,
"purchase_date": "2025-06-26T16:55:57Z",
"free_purchase": false,
"price": 20.0,
"price_formatted": "$20",
"donation_amount": null,
"donation_amount_formatted": null,
"app_fee": 0.59,
"app_fee_formatted": "$0.59",
"stripe_fee": 1.47,
"stripe_fee_formatted": "$1.47",
"cover_fee_amount": 0.0,
"cover_fee_amount_formatted": "$0",
"slug": "6-3p50ikzqg0",
"preferences_answer": null
}
}
}
How to verify that the webhook received at your endpoint URL was triggered by Donorbox?
Since your endpoint URLs are public, it is easily accessible to any third party on the internet. That means anyone with malicious intentions can flood your endpoint URL with bad requests pretending it to be from Donorbox. To overcome such bad actors, Donorbox sends a signed signature for each webhook notification request. More details about how to validate the webhook requests from Donorbox can be found in this guide https://donorbox.zendesk.com/hc/en-us/articles/17982194843028.
Webhook notification delays
Webhook notifications are typically anticipated to be dispatched promptly within a few seconds of the triggering event, barring peak periods when our daily recurring scheduler is activated. During this interval, there may be a noticeable augmentation in the size of the webhook queue, resulting in a delay of up to approximately one hour.
If you have any queries/suggestions, please reach out to our support team at support@donorbox.org.