Fundraise Up

https://api.fundraiseup.com/v1

Authentication

API Key Generation

Authentication Header

Authorization: Bearer YOUR_API_KEY

Important Notes

Rate Limits

Required Headers

Content-Type: application/json
Accept: application/json
Authorization: Bearer YOUR_API_KEY

API Endpoints

1. Donations

Request Body:

{
  "campaign_id": "FUNCPJTZZQR",
  "amount": "25.00",
  "currency": "usd",
  "payment_method_id": "pm_1234567890abcdef",
  "supporter": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone": "+1234567890",
    "mailing_address": {
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "New York",
      "region": "NY",
      "postal_code": "10001",
      "country": "us"
    }
  },
  "recurring_plan": {
    "frequency": "monthly"
  },
  "designation": [
    {
      "id": "EHHJ9R36"
    }
  ],
  "tribute": {
    "type": "in_honor_of",
    "honoree": "Jane Smith"
  },
  "comment": "Monthly donation for general fund",
  "anonymous": false,
  "custom_fields": [
    {
      "name": "referral_source",
      "value": "Email Campaign"
    }
  ]
}

Required Fields:

2. Recurring Plans

5. Campaigns

Code Examples

Python Example

import requests
import os
API_KEY = os.environ.get('FUNDRAISEUP_API_KEY')
BASE_URL = 'https://api.fundraiseup.com/v1'
headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
}
List donations
def get_donations(limit=50):
    url = f'{BASE_URL}/donations'
    params = {'limit': limit}
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()
Create donation
def create_donation(campaign_id, amount, currency, payment_method_id, supporter):
    url = f'{BASE_URL}/donations'
    data = {
        'campaign_id': campaign_id,
        'amount': str(amount),
        'currency': currency,
        'payment_method_id': payment_method_id,
        'supporter': supporter
    }
    response = requests.post(url, headers=headers, json=data)
    response.raise_for_status()
    return response.json()
Get single donation
def get_donation(donation_id):
    url = f'{BASE_URL}/donations/{donation_id}'
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    return response.json()

Node.js Example

const axios = require('axios');
const API_KEY = process.env.FUNDRAISEUP_API_KEY;
const BASE_URL = 'https://api.fundraiseup.com/v1';
const headers = {
  'Authorization': Bearer ${API_KEY},
  'Accept': 'application/json',
  'Content-Type': 'application/json'
};
// List donations
async function getDonations(limit = 50) {
  const response = await axios.get(${BASE_URL}/donations, {
    headers,
    params: { limit }
  });
  return response.data;
}
// Create donation
async function createDonation(campaignId, amount, currency, paymentMethodId, supporter) {
  const response = await axios.post(${BASE_URL}/donations, {
    campaign_id: campaignId,
    amount: amount.toString(),
    currency,
    payment_method_id: paymentMethodId,
    supporter
  }, { headers });
  return response.data;
}
// Get single donation
async function getDonation(donationId) {
  const response = await axios.get(${BASE_URL}/donations/${donationId}, { headers });
  return response.data;
}

cURL Example with Environment Variable

# Set your API key as environment variable
export FUNDRAISEUP_API_KEY="your_api_key_here"
List donations
curl --request GET \
  --url 'https://api.fundraiseup.com/v1/donations?limit=50' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer $FUNDRAISEUP_API_KEY"
Create donation
curl --request POST \
  --url 'https://api.fundraiseup.com/v1/donations' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer $FUNDRAISEUP_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "campaign_id": "FUNCPJTZZQR",
    "amount": "25.00",
    "currency": "usd",
    "payment_method_id": "pm_1234567890",
    "supporter": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com"
    }
  }'
Get single donation
curl --request GET \
  --url "https://api.fundraiseup.com/v1/donations/DFQLCFEP" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer $FUNDRAISEUP_API_KEY"

Testing

Test Mode

URL Parameter for Testing

Integration Patterns

Historical Data Sync

Real-time Polling

Event-Based Integration

Common Use Cases

1. Processing Offline Donations - Face-to-face fundraising - Direct mail donations - Telethon pledges - Event registrations

2. CRM Integration - Sync donation data to CRM (Salesforce, HubSpot, etc.) - Update supporter records - Track recurring plans - Generate reports

3. Analytics and Reporting - Export donation data for BI tools - Track campaign performance - Analyze donor behavior - Calculate lifetime value

4. Donor Portal Integration - Seamless authentication from custom portals - Direct access to recurring plan management - Single sign-on experience

Security Best Practices

1. API Key Management - Store API keys in environment variables (never hardcode) - Use separate keys for different integrations - Rotate keys periodically - Revoke compromised keys immediately

2. HTTPS Only - All requests must use HTTPS - HTTP requests are rejected

3. Data Validation - Validate all input before sending to API - Sanitize user-provided data - Check response data before processing

4. PCI Compliance - Never handle raw card data in your application - Use Stripe Payment Methods API for card processing - Meet PCI DSS requirements (SAQ D for direct API integration) - Consider using Stripe Elements to reduce PCI scope

5. Donor Portal Security - Validate supporter ownership before generating access links - Use automatic redirects (never manual links) - Never share access links via email or public channels - Access links expire in 1 minute

Limitations and Considerations

1. Payment Methods: Currently only credit cards are supported 2. Updates: Only allowed within 24 hours of creation, only for API-created records 3. Bulk Operations: No bulk update support 4. Webhooks: Direct webhooks not supported (use Zapier for events) 5. Subaccounts: Parent API keys cannot create donations for subaccounts 6. Fee Calculations: Fees may be 0 initially; use Events endpoint for finalized fees 7. Address Validation: API does not format or verify addresses 8. Email Validation: API does not verify email addresses 9. Migration: REST API is not a migration mechanism (use Migration service)

Additional Resources

Troubleshooting

Common Issues

401 Unauthorized

429 Rate Limit Exceeded

400 Bad Request

Fees Showing as 0