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.

Contact Notes

Manage notes on a contact record. Notes support types (GENERAL, CALL, MEETING, EMAIL, EVENT, DONATION, PERSONAL, BUSINESS, FOLLOW_UP, SYSTEM), a subject line, and privacy controls.

GET/v1/contacts/:id/notes

List all notes for a contact.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).

curl -X GET "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/notes" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret"

Response

[
  {
    "id": "note_abc123",
    "contactId": "cnt_abc123",
    "subject": "Follow-up call",
    "content": "Discussed annual gala sponsorship.",
    "noteType": "CALL",
    "isPrivate": false,
    "isImportant": true,
    "createdBy": null,
    "createdAt": "2026-02-17T10:00:00Z",
    "updatedAt": "2026-02-17T10:00:00Z"
  }
]

POST/v1/contacts/:id/notes

Add a note to a contact.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).
`content`	string	Yes	The note content.
`subject`	string	No	Note subject line.
`noteType`	string	No	GENERAL, CALL, MEETING, EMAIL, EVENT, DONATION, PERSONAL, BUSINESS, FOLLOW_UP, or SYSTEM (default GENERAL).
`isPrivate`	boolean	No	Mark as private (default false).
`isImportant`	boolean	No	Mark as important (default false).

curl -X POST "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/notes" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Follow-up call",
    "content": "Discussed annual gala sponsorship. Will send proposal by Friday.",
    "noteType": "CALL",
    "isImportant": true
  }'

Response

{
  "id": "note_abc123",
  "contactId": "cnt_abc123",
  "subject": "Follow-up call",
  "content": "Discussed annual gala sponsorship. Will send proposal by Friday.",
  "noteType": "CALL",
  "isPrivate": false,
  "isImportant": true,
  "createdBy": null,
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}

PUT/v1/contacts/:id/notes/:noteId

Update an existing note.

curl -X PUT "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/notes/note_abc123" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Updated note content", "isImportant": false }'

DELETE/v1/contacts/:id/notes/:noteId

Remove a note from a contact.

curl -X DELETE "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/notes/note_abc123" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret"