Bloomerang

Bloomerang is a cloud-based donor management and fundraising CRM built for small and mid-size nonprofits, covering constituent records, donations and pledges, communications, and reporting. Bloomerang acquired fellow nonprofit platform Kindful in January 2021, but Kindful continues to run its own separate API and product line; this entry documents Bloomerang's own REST API v2 (base https://api.bloomerang.co/v2), authenticated with a private API key or OAuth 2.0, for managing constituents, transactions, interactions, and related donor data.

10 APIs 0 Features
NonprofitDonor ManagementCRMFundraisingFundraising Software

APIs

Bloomerang Constituents API

Create, retrieve, search, and update constituent records - the individuals, households, and organizations tracked in a Bloomerang donor database - including addresses, emails, p...

Bloomerang Households API

Manage households - the family-unit grouping of individual constituents used throughout Bloomerang for giving history rollups and household-level mailings and reporting.

Bloomerang Transactions API

Record and retrieve transactions - the total amount of a payment, split into one or more designations such as donations, pledges, pledge payments, recurring donations, or recurr...

Bloomerang Interactions API

Log and retrieve interactions - a "touch" between the organization and a constituent such as a call, meeting, letter, or email - used to build the constituent engagement timeline.

Bloomerang Notes API

Create and retrieve freeform notes attached to a constituent record, including optional file attachments, surfaced on the constituent timeline alongside interactions and transac...

Bloomerang Relationships API

Manage relationships between two constituents - such as spouse, employer, or board member - each carrying a role on both sides of the relationship and an optional note.

Bloomerang Custom Fields API

Retrieve the custom field definitions configured for a given object type (Constituent, Transaction, Interaction, Note) so integrations can read and write an organization's accou...

Bloomerang Lists API

Read saved constituent lists (segments) built in the Bloomerang CRM UI, and page through the constituents they contain, for use in exports, mailings, and downstream reporting. M...

Bloomerang Webhooks API

Register, list, and remove webhook subscriptions so a third-party system receives an HTTP callback when events occur in Bloomerang, such as a new constituent or transaction bein...

Bloomerang Accounts and Users API

Read account-level reference data - CRM users, funds, campaigns, and appeals - used to populate designations on transactions and to attribute activity to a specific staff user.

Collections

Bloomerang REST API v2

OPEN

Pricing Plans

Bloomerang Plans Pricing

4 plans

PLANS

Rate Limits

Bloomerang Rate Limits

3 limits

RATE LIMITS

FinOps

Bloomerang Finops

FINOPS

Resources

🔗
TrustCenter
TrustCenter
🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
🔑
OAuthScopes
OAuthScopes
👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
📰
Blog
Blog

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Bloomerang REST API v2
  version: '2.0'
request:
  auth:
    type: apikey
    key: X-Api-Key
    value: '{{apiKey}}'
    in: header
items:
- info:
    name: Constituents
    type: folder
  items:
  - info:
      name: List constituents.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/constituents?skip=0&take=50
    docs: Lists constituents, paginated with skip/take parameters.
  - info:
      name: Create a constituent.
      type: http
    http:
      method: POST
      url: https://api.bloomerang.co/v2/constituents
      body:
        type: json
        data: "{\n  \"Type\": \"Individual\",\n  \"FirstName\": \"Ada\",\n  \"LastName\": \"Lovelace\"\n}"
    docs: Creates a new constituent record.
  - info:
      name: Search constituents.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/constituents/search?search=Lovelace
      params:
      - name: search
        value: Lovelace
        type: query
        description: Search term, e.g. a constituent's name.
    docs: Full-text search across constituent names and identifying fields.
  - info:
      name: Retrieve a constituent.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/constituents/:id
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the constituent.
    docs: Retrieves a constituent by ID.
  - info:
      name: Update a constituent.
      type: http
    http:
      method: PATCH
      url: https://api.bloomerang.co/v2/constituents/:id
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the constituent.
      body:
        type: json
        data: '{}'
    docs: Updates fields on an existing constituent.
  - info:
      name: Get a constituent's timeline.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/constituents/:id/timeline
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the constituent.
    docs: Retrieves the combined notes/interactions/donations/tasks timeline for a constituent.
- info:
    name: Households
    type: folder
  items:
  - info:
      name: Create a household.
      type: http
    http:
      method: POST
      url: https://api.bloomerang.co/v2/households
      body:
        type: json
        data: "{\n  \"Name\": \"The Lovelace Household\",\n  \"MemberIds\": []\n}"
    docs: Creates a household constituent grouping one or more individual constituent members. Modeled endpoint - see review.yml.
  - info:
      name: Retrieve a household.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/households/:id
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the household.
    docs: Retrieves a household by ID. Modeled endpoint - see review.yml.
  - info:
      name: Update a household.
      type: http
    http:
      method: PATCH
      url: https://api.bloomerang.co/v2/households/:id
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the household.
      body:
        type: json
        data: '{}'
    docs: Updates household membership or details. Modeled endpoint - see review.yml.
- info:
    name: Transactions
    type: folder
  items:
  - info:
      name: List transactions.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/transactions?skip=0&take=50
    docs: Lists transactions, paginated with skip/take parameters.
  - info:
      name: Create a transaction.
      type: http
    http:
      method: POST
      url: https://api.bloomerang.co/v2/transactions
      body:
        type: json
        data: "{\n  \"AccountId\": 1,\n  \"Date\": \"2026-07-03\",\n  \"Method\": \"CreditCard\",\n  \"Designations\": [ {\
          \ \"Type\": \"Donation\", \"FundId\": 1, \"Amount\": 100.00 } ]\n}"
    docs: Creates a transaction split into one or more designations against a fund and constituent.
  - info:
      name: Retrieve a transaction.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/transactions/:id
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the transaction.
    docs: Retrieves a transaction by ID.
- info:
    name: Interactions
    type: folder
  items:
  - info:
      name: List interactions.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/interactions?skip=0&take=50
    docs: Lists interactions, paginated with skip/take parameters.
  - info:
      name: Create an interaction.
      type: http
    http:
      method: POST
      url: https://api.bloomerang.co/v2/interactions
      body:
        type: json
        data: "{\n  \"AccountId\": 1,\n  \"Date\": \"2026-07-03\",\n  \"Channel\": \"Email\",\n  \"Purpose\": \"Thank you\"\
          \n}"
    docs: Creates an interaction - a logged touch between the organization and a constituent.
  - info:
      name: Retrieve an interaction.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/interactions/:id
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the interaction.
    docs: Retrieves an interaction by ID.
- info:
    name: Notes
    type: folder
  items:
  - info:
      name: Create a note.
      type: http
    http:
      method: POST
      url: https://api.bloomerang.co/v2/notes
      body:
        type: json
        data: "{\n  \"AccountId\": 1,\n  \"Note\": \"Met at the annual gala.\",\n  \"Date\": \"2026-07-03\"\n}"
    docs: Creates a freeform note attached to a constituent. Modeled endpoint - see review.yml.
  - info:
      name: Retrieve a note.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/notes/:id
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the note.
    docs: Retrieves a note by ID. Modeled endpoint - see review.yml.
- info:
    name: Relationships
    type: folder
  items:
  - info:
      name: List a constituent's relationships.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/constituents/:id/relationships
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the constituent.
    docs: Lists the relationships a constituent has to other constituents.
  - info:
      name: Create a relationship.
      type: http
    http:
      method: POST
      url: https://api.bloomerang.co/v2/constituents/:id/relationships
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the constituent.
      body:
        type: json
        data: "{\n  \"AccountId2\": 2,\n  \"RelationshipRole1\": \"Spouse\",\n  \"RelationshipRole2\": \"Spouse\"\n}"
    docs: Creates a relationship between the given constituent and another constituent.
- info:
    name: Custom Fields
    type: folder
  items:
  - info:
      name: List custom field definitions.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/customFields/:type
      params:
      - name: type
        value: Constituent
        type: path
        description: 'The object type: Constituent, Transaction, Interaction, or Note.'
    docs: Lists the custom field definitions configured for a given object type.
- info:
    name: Webhooks
    type: folder
  items:
  - info:
      name: List webhook subscriptions.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/webhooks
    docs: Lists the webhook subscriptions registered for the account.
  - info:
      name: Register a webhook subscription.
      type: http
    http:
      method: POST
      url: https://api.bloomerang.co/v2/webhooks
      body:
        type: json
        data: "{\n  \"url\": \"https://your-server.example.com/webhook\",\n  \"event\": \"constituent.created\",\n  \"active\"\
          : true\n}"
    docs: Registers a webhook subscription that receives an HTTP callback when the given event occurs.
  - info:
      name: Delete a webhook subscription.
      type: http
    http:
      method: DELETE
      url: https://api.bloomerang.co/v2/webhooks/:id
      params:
      - name: id
        value: ''
        type: path
        description: The ID of the webhook subscription.
    docs: Removes a webhook subscription.
- info:
    name: Reference Data
    type: folder
  items:
  - info:
      name: List CRM users.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/users
    docs: Lists the CRM users on the account. Modeled endpoint - see review.yml.
  - info:
      name: List funds.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/funds
    docs: Lists the funds available as transaction designations. Modeled endpoint - see review.yml.
  - info:
      name: List campaigns.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/campaigns
    docs: Lists fundraising campaigns. Modeled endpoint - see review.yml.
  - info:
      name: List appeals.
      type: http
    http:
      method: GET
      url: https://api.bloomerang.co/v2/appeals
    docs: Lists fundraising appeals. Modeled endpoint - see review.yml.
bundled: true