Developer Documentation

Contact Employment API Reference

Manage employment history on contact records. Add, update, and remove employment entries with company, title, and date range.

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"