# Get your Benevity disbursements through an API

> Read your disbursements and the donations and matches inside each one from the Benevity Causes Portal with one API call. A workflow can check for new disbursements every morning and hand each one's donations to your donor database or accounting.

Page: https://fous.com/automate/benevity-causes-portal
Updated: 2026-11-12

Works with your own Benevity Causes Portal account. Fous is an independent product.

## What you can build on the Causes Portal

### Get the donations in a disbursement

Opens one disbursement report in the Causes Portal and reads every donation and match it pays out, with fees and donor details where the donor shared them.

- Takes: Disbursement ID or Bank Reference ID
- Returns: Disbursement ID, disbursement date and, per transaction: transaction ID, donation date, company, project, donation and match amount, currency, cause support fee, merchant fee, donor name and email

### List recent disbursements

Reads your disbursements in the Causes Portal for a date range, with the identifiers and dates each disbursement report carries.

- Takes: From date, to date (optional)
- Returns: Disbursement ID, Bank Reference ID, disbursement date, bank date, payment method

### Create a project

Opens Projects, selects Create New Project, fills in the project and saves it as Published or as an Unpublished draft.

- Takes: Project name, description, expiry date (optional), goal amount (optional), published or draft
- Returns: Project name, status, goal amount, expiry date

## Automate the Causes Portal with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### New disbursements, posted to your donor database

Starts: Every weekday at 8:00

1. List recent disbursements and keep the ones that were not there on the last run.
2. For each one, get the donations in the disbursement.
3. Post each transaction with company, project, amounts, fees and shared donor details to your donor database or accounting webhook.

### Weekly thank-you list from new disbursements

Starts: Every Monday at 9:00

1. List the disbursements from the past 7 days.
2. For each one, get the donations and keep those where the donor shared a name or email.
3. Email you the list, grouped by company, with each donor, amount, match and project.

### Monthly giving summary by company

Starts: On the 1st of every month at 9:00

1. List last month's disbursements and get the donations in each.
2. Have an AI step total donations, matches and fees by company and by project.
3. Email you the summary.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get the donations in a disbursement” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "causes.benevity.org/get_disbursement_donations",
    "input": {
      "disbursement_id": "4QX8ZK21LM"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "disbursement_id": "4QX8ZK21LM",
    "disbursement_date": "2026-11-06",
    "transactions": [
      {
        "transaction_id": "T-55102931",
        "donation_date": "2026-10-14",
        "company_name": "Acme",
        "project_name": "Winter coat drive",
        "donation_amount": 100,
        "match_amount": 100,
        "donation_currency": "USD",
        "cause_support_fee": 5,
        "merchant_fee": 2.2,
        "donor_name": "Jordan Example",
        "donor_email": "Not shared by donor"
      }
    ]
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The Causes Portal’s own options

Benevity's pages for nonprofits describe no API for causes. What it gives you is the Causes Portal: a profile, projects, volunteering opportunities, a dashboard for grant application status and disbursement reports that show who donated and how much. Registering and receiving donations are free.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Disbursement reports | A CSV export with each donation and match, its currency, the fees and the donor details the donor shared. | A Causes Portal account. |
| Dashboard | Tracks the status of your grant applications. | A Causes Portal account. |
| The Causes Portal by hand | Cause Profile, Projects, volunteering opportunities, grant application status and disbursement reports. | A free registration for your nonprofit. |

Read on November 12, 2026: [Benevity for nonprofits](https://benevity.com/nonprofits), [How to connect with donors and volunteers through the Benevity Causes Portal](https://go.benevity.com/hubfs/website/npo/How-to-Connect-with-Donors-Volunteers-Through-the-Benevity-Causes-Portal.pdf).

## Signing in to the Causes Portal

The Causes Portal signs you in with your username or email and a password. With Fous you sign in once through the portal's own sign-in with your own account: the login is sealed with AES-256, code and agents never see it, and an expired session is signed back in.

## Worth knowing

- **Donor details only when shared**: In the disbursement report, donor name, email and address read Not shared by donor when the donor is anonymous, and Company Name does when it is withheld.
- **Two report formats**: The Causes Portal exports the new disbursement report and the legacy one from the previous portal. The new one includes a Foreign Exchange Rate column.
- **Edits take up to 24 hours**: Edits in the Causes Portal can take up to 24 hours to appear. Allow for that delay after you create or change a project.

## More in Education, research and nonprofit

- [Slate](https://fous.com/automate/slate.md)
- [Naviance](https://fous.com/automate/naviance.md)
- [Common App for Recommenders](https://fous.com/automate/common-app-for-recommenders.md)
- [National Student Clearinghouse secure site](https://fous.com/automate/national-student-clearinghouse-secure-site.md)
- [AQA Centre Services](https://fous.com/automate/aqa-centre-services.md)
- [Edexcel Online](https://fous.com/automate/edexcel-online.md)
- [FSA Partner Connect](https://fous.com/automate/fsa-partner-connect.md)
- [Submit learner data](https://fous.com/automate/submit-learner-data.md)
- [VA Enrollment Manager](https://fous.com/automate/va-enrollment-manager.md)
- [Sponsorship Management System](https://fous.com/automate/sponsorship-management-system.md)
- [Infinite Campus](https://fous.com/automate/infinite-campus.md)
- [PowerSchool SIS](https://fous.com/automate/powerschool-sis.md)
- [EDOF](https://fous.com/automate/edof.md)
- [Arbor MIS](https://fous.com/automate/arbor-mis.md)
- [SLC HEP Services](https://fous.com/automate/slc-hep-services.md)
- [Parchment](https://fous.com/automate/parchment.md)
- [UCAS adviser portal](https://fous.com/automate/ucas-adviser-portal.md)

Other industries: [Hydro One myAccount](/automate/hydro-one-myaccount), [Uber Eats Manager](/automate/uber-eats-manager), [KlikBCA Bisnis](/automate/klikbca-bisnis), [e-OSCAR](/automate/e-oscar), [登記情報提供サービス](/automate/registry-information-service), [TRACES](/automate/traces).

## Frequently asked questions

### Does the Benevity Causes Portal have an API?

Not one that Benevity's pages for nonprofits describe. You get the portal itself, where you export the disbursement report as a CSV file.

### How do I get a Benevity disbursement report?

Sign in to the Causes Portal and export the disbursement report as a CSV file. Each row is one donation or match, with its Transaction ID, Donation Date, Donation Amount, Match Amount, fees, Project Name and Company Name.

### Why can't I see a donor's name or email?

The donor did not share them. The disbursement report shows Not shared by donor in the donor name, email and address columns for anonymous donors.

### Is Fous affiliated with Benevity?

No. Fous is an independent product. You use it with your own Causes Portal account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Benevity Causes Portal (Benevity). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.