Developer Documentation

Contact Emails API Reference

Manage email addresses on contact records. Add, update, and remove emails with type and primary designation.

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"