Scripting on Volunteering
Post-Processing Script on Volunteer Items
When it runs: After a volunteer registration transaction is saved
Purpose: Notify supervisor, update hours totals, trigger recognition workflows
Common uses:
- Send a welcome message to the volunteer with shift details
- Notify the volunteer coordinator of a new registration
- Update the contact’s volunteer hours custom field
- Trigger a recognition email when a cumulative hours threshold is reached
Configure on the Volunteer Package Item’s Integration tab.
Event Handlers on Volunteer Records
When they run: When a Volunteer Instance is created or updated directly (not via a form)
Purpose: Sync to external volunteer management systems
Configure via Integration → Event Handlers, select “Volunteer Instance” as the entity.
| Event | When It Fires |
|---|---|
postInsertVolunteerInstance |
A new volunteer record is created |
postUpdateVolunteerInstance |
An existing volunteer record is updated |
Script Context
| Variable | Contents |
|---|---|
orderItem |
The Volunteer Order Item (via form) |
purchaseOrder |
The registration transaction (via form) |
contact |
The volunteer’s Contact record |
account |
The DonorPoint account |
For Event Handler context: instance contains the Volunteer Instance record.
→ Full context reference: Scripting Contexts