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 Emails

Manage email addresses on a contact record. Each email has a type (PERSONAL, WORK, OTHER) and an optional primary designation. Only one email can be primary per contact.

GET/v1/contacts/:id/emails

List all email addresses 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/emails" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret"

Response

[
  {
    "id": "em_abc123",
    "contactId": "cnt_abc123",
    "emailAddress": "jane@personal.com",
    "emailType": "PERSONAL",
    "isPrimary": false,
    "isVerified": false,
    "notes": null,
    "createdAt": "2026-02-17T10:00:00Z",
    "updatedAt": "2026-02-17T10:00:00Z"
  }
]

POST/v1/contacts/:id/emails

Add an email address to a contact.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).
`emailAddress`	string	Yes	The email address.
`emailType`	string	No	PERSONAL, WORK, or OTHER (default PERSONAL).
`isPrimary`	boolean	No	Set as the primary email.
`notes`	string	No	Additional notes.

curl -X POST "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/emails" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{ "emailAddress": "jane@personal.com", "emailType": "PERSONAL", "isPrimary": false }'

Response

{
  "id": "em_abc123",
  "contactId": "cnt_abc123",
  "emailAddress": "jane@personal.com",
  "emailType": "PERSONAL",
  "isPrimary": false,
  "isVerified": false,
  "notes": null,
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}

PUT/v1/contacts/:id/emails/:emailId

Update an existing email address.

curl -X PUT "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/emails/em_abc123" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{ "emailType": "WORK", "isPrimary": true }'

DELETE/v1/contacts/:id/emails/:emailId

Remove an email address from a contact.

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