Developer Documentation

Contact Phones API Reference

Manage phone numbers on contact records. Add, update, and remove phone numbers with type and primary designation.

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"