Developer Documentation

Contact Tags API Reference

Manage tags on contact records. Add, replace, and remove tags for categorization and segmentation.

Contact Tags

Manage tags on a contact record. Tags are string labels used for categorization and segmentation. All tag operations use the contacts:read or contacts:write scopes.

GET/v1/contacts/:id/tags

List all tags on a contact.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).

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

Response

{
  "tags": ["major-donor", "volunteer", "gala-2026"]
}

POST/v1/contacts/:id/tags

Add tags to a contact. Existing tags are preserved; duplicates are ignored.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).
`tags`	string[]	Yes	Array of tags to add.

curl -X POST "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/tags" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["vip", "board-member"]}'

PUT/v1/contacts/:id/tags

Replace all tags on a contact with the provided set.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).
`tags`	string[]	Yes	Complete set of tags (replaces existing).

curl -X PUT "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/tags" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["major-donor", "recurring"]}'

DELETE/v1/contacts/:id/tags

Remove specific tags from a contact.

Name	Type	Required	Description
`id`	string	Yes	Contact ID (path).
`tags`	string[]	Yes	Tags to remove.

curl -X DELETE "https://api.fundraisermax.com/api/v1/contacts/cnt_abc123/tags" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["volunteer"]}'