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 Phones

Manage phone numbers on a contact record. Each phone has a type (MOBILE, HOME, WORK, FAX, OTHER) and an optional primary designation. Only one phone can be primary per contact.

GET/v1/contacts/:id/phones

List all phone numbers 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/phones" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret"

Response

[
  {
    "id": "ph_abc123",
    "contactId": "cnt_abc123",
    "phoneNumber": "+1-555-0300",
    "phoneType": "WORK",
    "isPrimary": false,
    "extension": null,
    "description": null,
    "notes": null,
    "createdAt": "2026-02-17T10:00:00Z",
    "updatedAt": "2026-02-17T10:00:00Z"
  }
]

POST/v1/contacts/:id/phones

Add a phone number to a contact.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).
`phoneNumber`	string	Yes	The phone number.
`phoneType`	string	No	MOBILE, HOME, WORK, FAX, or OTHER (default MOBILE).
`isPrimary`	boolean	No	Set as the primary phone number.
`extension`	string	No	Phone extension.
`description`	string	No	Short description.
`notes`	string	No	Additional notes.

curl -X POST "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/phones" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{ "phoneNumber": "+1-555-0300", "phoneType": "WORK", "isPrimary": false }'

Response

{
  "id": "ph_abc123",
  "contactId": "cnt_abc123",
  "phoneNumber": "+1-555-0300",
  "phoneType": "WORK",
  "isPrimary": false,
  "extension": null,
  "description": null,
  "notes": null,
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}

PUT/v1/contacts/:id/phones/:phoneId

Update an existing phone number. Send only the fields you want to change.

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

DELETE/v1/contacts/:id/phones/:phoneId

Remove a phone number from a contact.

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