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 Employment

Manage employment history on a contact record. Track companies, job titles, departments, employment types, and date ranges.

GET/v1/contacts/:id/employment

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

Response

[
  {
    "id": "emp_abc123",
    "contactId": "cnt_abc123",
    "companyName": "Doe Foundation",
    "jobTitle": "Executive Director",
    "department": null,
    "employmentType": "FULL_TIME",
    "startDate": "2020-01-15",
    "endDate": null,
    "isCurrent": true,
    "salaryRange": null,
    "description": null,
    "createdAt": "2026-02-17T10:00:00Z",
    "updatedAt": "2026-02-17T10:00:00Z"
  }
]

POST/v1/contacts/:id/employment

Add an employment record to a contact.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).
`companyName`	string	Yes	Company or organization name.
`jobTitle`	string	No	Job title.
`department`	string	No	Department within the company.
`employmentType`	string	No	FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, VOLUNTEER, or OTHER.
`startDate`	string	No	Start date (ISO 8601).
`endDate`	string	No	End date (ISO 8601). Null if current.
`isCurrent`	boolean	No	Currently employed here (default false).
`salaryRange`	string	No	Salary range estimate.
`description`	string	No	Role description.

curl -X POST "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/employment" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Doe Foundation",
    "jobTitle": "Executive Director",
    "employmentType": "FULL_TIME",
    "startDate": "2020-01-15",
    "isCurrent": true
  }'

Response

{
  "id": "emp_abc123",
  "contactId": "cnt_abc123",
  "companyName": "Doe Foundation",
  "jobTitle": "Executive Director",
  "department": null,
  "employmentType": "FULL_TIME",
  "startDate": "2020-01-15",
  "endDate": null,
  "isCurrent": true,
  "salaryRange": null,
  "description": null,
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}

PUT/v1/contacts/:id/employment/:employmentId

Update an existing employment record.

curl -X PUT "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/employment/emp_abc123" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{ "jobTitle": "CEO", "department": "Executive" }'

DELETE/v1/contacts/:id/employment/:employmentId

Remove an employment record from a contact.

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