Developer Documentation

Contact Addresses API Reference

Manage mailing addresses on contact records. Add, update, and remove addresses with full address fields and geocoding.

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"