You May Want Javascript For This

Your browser currently has Javascript turned off. While some things, like signing petitions, will work without Javascript you may encounter errors. If you do, enabling JavaScript should get around the problems.

Actions

People

Fundraising Pages Version 1

Note: This documentation describes Version 1 of our API, which is now depreciated. It will continue to work, but it will not reveive any updates or bug fixes. We recommend you use Version 2 instead. Documentation for this resource for Version 2 of our API is available here.

This document describes the OSDI fundraising pages collection and fundraising page resource as implemented by the Action Network.

Fundraising pages are a type of action created by the organizer or group associated with your API key that involves activists donating money to one or more recipients.

Fundraising pages have summaries (titles) and can have descriptions and other fields, and when activists donate on them donation resources are created representing the donation an activist made on that fundraising page.

Fundraising pages are not deduplicated except on identifiers, to keep identifiers unique.

Endpoints and URL structures

Fundraising page resources live exclusively at the above endpoint. The endpoint returns a collection of all the fundraising pages associated with your API key.

URL Structures:

https://actionnetwork.org/api/v1/fundraising_pages/[id]

To address a specific fundraising page, use the identifier without the action_network: prefix to construct a URL, like https://actionnetwork.org/api/v1/fundraising_pages/d91b4b2e-ae0e-4cd3-9ed7-d0ec501b0bc3

Scenario: Retrieving a collection of fundraising page resources (GET)

Fundraising page resources are sometimes presented as collections of fundraising pages. For example, calling the fundraising page endpoint will return a collection of all the fundraising pages associated with your API key.

Scenario: Creating a new fundraising page (POST)

You can post a new fundraising page to the fundraising pages endpoint and a fundraising page resource will be created in our system.

Note: Fundraising pages created via the API in this way are not equivalent to fundraising pages created with our user interface. API-created fundraising pages will not show up in lists of all of your actions on your dashboard of group page, they will not be given a URL on actionnetwork.org where people can donate, they will not have individual manage pages for statistics and counting of amounts, and they will not actually charge users any money. Rather, once they have at least one donation, they will show up as actions available for selection in our targeting interface, allowing you to select all people who have taken action on that fundraising page for reports or email targeting.

In the targeting interface, they will show up in the format [1, (originating system) Fundraiser], (summary). For example, a fundraising page with the originating system "FreeFundraisers.com" and the summary "My Free Fundraiser" will show up in the targeting interface as [1, FreeFundraisers.com Fundraiser], My Free Fundraiser so you can easily identify what it is and where it came from when doing your targeting.

In the above example, you can see how the foreign identifier being posted is merged into the identifiers array. We will intelligently search and deduplicate based on foreign and native identifiers. So if you post a fundraising page with an identifier that matches one already assigned to a fundraising page resource, your POST request will update that resource with new information instead of creating a duplicate.

You can post a fundraising page with a creator link as well, if you want to assign the fundraising page to a specific Action Network user, like so:

The link must be a valid person resource and must be associated with your API key for it to be accepted. If your API key is for an individual account, then the link must be to your account's person resource. If your API key is for a group, then the link must be to a member of administrator of your group. If no link or an invalid link is provided, the fundraising page will be assigned to your API key's account person record or to the original creator of the group, whichever is appropriate. Who the creator is has no effect on what email list people who donation on the fundraising page are subscribed to.

And of course you can post a fundraising page with more fields (such as description) if you'd like, but they are not required.

The above example added a new identifier to the fundraising page, changed the summary, and added a description.

Editing of certain fields via PUT is not allowed, and is noted in the field names table above. For example, you can't change the total_donations count -- that is a system generated number reflecting a count of the underlying donations. And you can't change a creator of a fundraising page. Invalid entries will be ignored.

Action Network is an open platform that empowers individuals and groups to organize for progressive causes. We encourage responsible activism, and do not support using the platform to take unlawful or other improper action. We do not control or endorse the conduct of users and make no representations of any kind about them.

Get Help

Get In Touch

Want to partner with us?

Action Network partners get access to our full range of tools, including the ability to upload activists and subscribe them to your list, create custom-branded email and page wrappers, and more. Join organizations large and small who've made the switch!