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 Addresses

Manage mailing addresses on a contact record. Each address has a type (HOME, WORK, MAILING, OTHER) and an optional primary designation. Addresses support full international formatting.

GET/v1/contacts/:id/addresses

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

Response

[
  {
    "id": "addr_abc123",
    "contactId": "cnt_abc123",
    "streetAddress1": "123 Main St",
    "streetAddress2": null,
    "city": "Springfield",
    "stateProvince": "IL",
    "postalCode": "62701",
    "country": "US",
    "addressType": "HOME",
    "isPrimary": true,
    "createdAt": "2026-02-17T10:00:00Z",
    "updatedAt": "2026-02-17T10:00:00Z"
  }
]

POST/v1/contacts/:id/addresses

Add an address to a contact.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).
`streetAddress1`	string	Yes	Street address line 1.
`streetAddress2`	string	No	Street address line 2.
`city`	string	Yes	City name.
`stateProvince`	string	Yes	State or province.
`postalCode`	string	Yes	Postal / ZIP code.
`country`	string	No	Country code (default US).
`county`	string	No	County name.
`addressType`	string	No	HOME, WORK, MAILING, or OTHER (default HOME).
`isPrimary`	boolean	No	Set as the primary address.
`notes`	string	No	Additional notes.

curl -X POST "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/addresses" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "streetAddress1": "123 Main St",
    "city": "Springfield",
    "stateProvince": "IL",
    "postalCode": "62701",
    "addressType": "HOME",
    "isPrimary": true
  }'

Response

{
  "id": "addr_abc123",
  "contactId": "cnt_abc123",
  "streetAddress1": "123 Main St",
  "streetAddress2": null,
  "city": "Springfield",
  "stateProvince": "IL",
  "postalCode": "62701",
  "country": "US",
  "addressType": "HOME",
  "isPrimary": true,
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}

PUT/v1/contacts/:id/addresses/:addressId

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

curl -X PUT "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/addresses/addr_abc123" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{ "streetAddress1": "456 Oak Ave", "city": "Chicago" }'

DELETE/v1/contacts/:id/addresses/:addressId

Remove an address from a contact.

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