Developer Documentation

Everything you need to integrate with the FundraiserMax API. Build custom workflows, sync donor data, and connect AI assistants to your fundraising platform.

Donations

The Donations API allows you to query donation records and create new donation entries. Use date range filters to pull transaction data for reporting and reconciliation.

GET/v1/donations

Retrieve a paginated list of donations. Supports date range filtering for reporting.

Name	Type	Required	Description
`accountId`	string	Yes	Your organization account ID.
`limit`	number	No	Number of records to return (default 20, max 100).
`offset`	number	No	Number of records to skip for pagination (default 0).
`startDate`	string	No	ISO 8601 date. Only return donations on or after this date.
`endDate`	string	No	ISO 8601 date. Only return donations on or before this date.

curl -X GET "https://api.fundraisermax.com/api/v1/donations?accountId=acct_123&startDate=2026-01-01&endDate=2026-02-16&limit=20" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret"

Response

{
  "data": [
    {
      "id": "don_jkl654",
      "contactId": "cnt_abc123",
      "contactName": "Jane Doe",
      "amount": 500.00,
      "donationDate": "2026-01-15T00:00:00Z",
      "paymentMethod": "credit_card",
      "campaignId": "cmp_xyz789",
      "campaignName": "Spring Annual Fund 2026",
      "notes": "Recurring monthly gift",
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
  "total": 47,
  "limit": 20,
  "offset": 0
}

POST/v1/donations

Record a new donation. The donation will be associated with the specified contact and optionally linked to a campaign.

Name	Type	Required	Description
`accountId`	string	Yes	Your organization account ID.
`contactId`	string	Yes	The ID of the donor contact.
`amount`	number	Yes	Donation amount in USD.
`donationDate`	string	Yes	ISO 8601 date of the donation.
`paymentMethod`	string	No	Payment method: credit_card, check, cash, bank_transfer, other.
`campaignId`	string	No	Optional campaign to associate with this donation.
`notes`	string	No	Free-text notes about the donation.

curl -X POST "https://api.fundraisermax.com/api/v1/donations" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acct_123",
    "contactId": "cnt_abc123",
    "amount": 250.00,
    "donationDate": "2026-02-16",
    "paymentMethod": "check",
    "notes": "Annual pledge payment 2 of 4"
  }'

Response

{
  "id": "don_mno987",
  "contactId": "cnt_abc123",
  "contactName": "Jane Doe",
  "amount": 250.00,
  "donationDate": "2026-02-16T00:00:00Z",
  "paymentMethod": "check",
  "campaignId": null,
  "campaignName": null,
  "notes": "Annual pledge payment 2 of 4",
  "createdAt": "2026-02-16T15:00:00Z"
}