asebesta Bloomerang API
Reference for integrating with the Bloomerang CRM REST API (OpenAPI 3.0, v2.0.0).
Base URL
https://api.bloomerang.co/v2
Authentication
API Key (recommended for integrations):
X-API-KEY: <your-api-key>
OAuth 2.0 (for user-based interactions):
- Authorization URL:
https://crm.bloomerang.com/authorize/ - Token URL:
https://api.bloomerang.co/v2/oauth/token - Scopes:
ViewOnly,StandardEditFinancialData,Standard,OrgAdmin
Pagination
All list endpoints use skip and take parameters:
take: Max 50 items per request (default)skip: Offset for pagination- Response includes
Total,TotalFiltered,Start,ResultCount
Key Endpoints
Constituents (Donors)
GET /constituents # List constituents
GET /constituent/{id} # Get single constituent
POST /constituent # Create constituent
PUT /constituent/{id} # Update constituent
DELETE /constituent/{id} # Delete constituent
GET /constituents/search # Search constituents
GET /constituent/{id}/timeline # Get constituent timeline
GET /constituent/{id}/relationships # Get relationships
POST /constituent/merge # Merge duplicates
Households
GET /households # List households
GET /household/{id} # Get household
POST /household # Create household
PUT /household/{id} # Update household
Transactions (Gifts)
GET /transactions # List transactions
GET /transaction/{id} # Get single transaction
POST /transaction # Create transaction
PUT /transaction/{id} # Update transaction
DELETE /transaction/{id} # Delete transaction
GET /transactions/designations # Get designations
Pledges
GET /pledge/{id}/installments # Get pledge installments
GET /pledge/{id}/payments # Get pledge payments
POST /pledge/generateInstallments # Generate installments
POST /pledge/{id}/writeOff # Write off pledge
Interactions
GET /interactions # List interactions
GET /interaction/{id} # Get interaction
POST /interaction # Create interaction
PUT /interaction/{id} # Update interaction
DELETE /interaction/{id} # Delete interaction
Campaigns & Appeals
GET /campaigns # List campaigns
GET /campaign/{id} # Get campaign
POST /campaign # Create campaign
GET /appeals # List appeals
GET /appeal/{id} # Get appeal
POST /appeal # Create appeal
Tasks
GET /tasks # List tasks
GET /task/{id} # Get task
POST /task # Create task
PUT /task/{id} # Update task
POST /task/{id}/complete # Complete task
Other Resources
GET /funds # List funds
GET /notes # List notes
GET /refunds # List refunds
GET /softcredits # List soft credits
GET /tributes # List tributes
GET /walletitems # List wallet items
GET /relationshiproles # List relationship roles
ID vs AccountNumber
Bloomerang distinguishes between:
- ID: API identifier (use in API calls)
- AccountNumber: UI-friendly reference (displayed to users)
Full API Reference
For complete endpoint specifications, request/response schemas, and examples, search the OpenAPI spec (do not read the full file - it's 1.5MB):
references/bloomerang-openapi.json
Search patterns (use grep or jq):
- Endpoints:
jq '.paths | keys' - Schemas:
jq '.components.schemas | keys' - Specific endpoint:
jq '.paths["/constituent/{id}"]'
Disclaimer
This skill is not affiliated with, endorsed by, or sponsored by Bloomerang. It references publicly available API documentation for educational and integration purposes. The information may be outdated or incomplete. Always refer to the official Bloomerang documentation for the most current API specifications.