Overview
Add Bloomerang to any ModuleX agent or workflow. Nonprofit donor management and fundraising CRM platform integration against the Bloomerang REST API (api.bloomerang.co/v2).
Categories: CRM · Nonprofit · Fundraising · Auth: API Key · Actions: 3
Authentication
API Key Authentication
Authenticate using your Bloomerang API key1
Step 1
Log in to your Bloomerang account
2
Step 2
Navigate to Settings > API Keys
3
Step 3
Create a new API key or copy your existing one
4
Step 4
Paste the API key below
Required Credentials
Available Actions
create_constituent — Creates a new constituent in Bloomerang
create_constituent — Creates a new constituent in Bloomerang
Parameters
string
required
Constituent type. Valid values: Individual, Organization
string
First name of the constituent (used when type is Individual)
string
Last name of the constituent (used when type is Individual)
string
Organization name (used when type is Organization)
string
Status of the constituent. Valid values: Active, Inactive, Deceased
string
Middle name of the constituent
string
Prefix/title. Valid values: Mr., Mrs., Ms., Mx., Dr., Rev., etc.
string
Suffix. Valid values: Jr., Sr., II, III, IV, V, Ph.D., M.D., Esq., etc.
string
Job title of the constituent
string
Gender. Valid values: Male, Female, Other
string
Birth date of the constituent (ISO format YYYY-MM-DD)
string
Employer of the constituent
string
Website URL of the constituent
string
Facebook page URL of the constituent
string
Twitter/X handle of the constituent
string
LinkedIn page URL of the constituent
string
Preferred communication channel. Valid values: Email, Phone, Text Message, Mail
Response
create_donation — Creates a new donation record in Bloomerang
create_donation — Creates a new donation record in Bloomerang
Parameters
string
required
ID of the constituent (donor)
string
required
Date of the donation (ISO format YYYY-MM-DD)
string
required
Donation amount as a numeric string
string
required
ID of the fund for the donation
string
required
Payment method. Valid values: None, Cash, Check, CreditCard, Eft, InKind, ApplePay, GooglePay, PayPal, Venmo
string
ID of the campaign for the donation
string
ID of the appeal for the donation
string
Note for the donation
Response
add_interaction — Adds an interaction to an existing constituent in Bloomerang
add_interaction — Adds an interaction to an existing constituent in Bloomerang
Parameters
string
required
ID of the constituent
string
required
Date of the interaction (ISO format YYYY-MM-DD)
string
required
Subject of the interaction
string
required
Channel of the interaction. Valid values: Email, InPerson, Mail, MassEmail, Other, Phone, SocialMedia, TextMessage, VideoCall, Webinar, Website
string
required
Purpose of the interaction. Valid values: Acknowledgement, ImpactCultivation, Newsletter, Receipt, Solicitation, SpecialEvent, VolunteerActivity, PledgeReminder, Welcome, Other
string
Note for the interaction
boolean
Whether the interaction was initiated by the constituent
Response
Limits & Quotas
- No publicly documented rate limits for the Bloomerang REST API v2.
- Error model: non-2xx responses and timeouts are caught and returned as
success=False+errorrather than raising.