Look Ups and Campaigns


This article provides information about working with LookUps and Campaigns via the API - i.e.

  • the lists you can maintain via Settings > Configuration
  • and the Campaigns within Donorfy


To return a list of the available lookup types, use the endpoint: https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes 

A successful call will retrieve a list of the lookup types you can work with - these broadly correspond to a subset of the list found via:

  • Settings > Configuration
  • Campaigns 



  • retrieve all the existing lookups of a given type you would use the https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes/<lookuptype> endpoint - e.g. to find all existing constituent types you would use https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes/ConstituentTypes
  • add a new entry to a lookup list Post to https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes/<lookuptype> - e.g. to add a new constituent type post to https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes/ConstituentTypes passing the constituent type as the lookup description 
  • Note that the API does not check that your new lookup does not already exist in the lookup list 





Work with tags as follows to

  • Retrieve tag categories use this endpoint https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes/TagCategory
  • Find all tags within a category https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes/<tagCategoryName>/Tags - e.g. If you had a tag category called Engagement https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes/Engagement/Tags
  • Add a tag post to https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes/<tagCategoryName>/Tags passing the tag name as the lookup description - e.g. To add a new tag Membership to the Engagement tag category Post to https://data.donorfy.com/api/v1/<apikey>/System/LookUpTypes/Engagement/Tags passing Membership as the lookup description - e.g. 
    • {
        "LookUpDescription": "Membership"



The Donorfy API is a Professional-only feature. Essential subscribers, please contact us to find out more about upgrading.


Please sign in to leave a comment.
Powered by Zendesk