Developer Documentation

API Authentication Guide

Learn how to authenticate with the FundraiserMax API using API keys and bearer tokens. Includes examples in curl, JavaScript, and Python.

Authentication

Every API request must include two credentials: an API Key ID (sent in the X-API-Key header) and the corresponding API Secret (sent as a Bearer token in the Authorization header). You must also include your accountId as a query parameter on GET requests or in the request body for POST and PUT requests.

Step-by-Step

  1. Generate an API key from your FundraiserMax dashboard under Settings > API Keys. Copy both the key ID and the secret — the secret is only shown once.
  2. Include the X-API-Key header with your key ID in every request.
  3. Include the Authorization: Bearer header with your API secret.
  4. Include accountId as a query parameter (GET) or in the JSON request body (POST/PUT) to identify your organization.

Example Request

curl -X GET "https://api.fundraisermax.com/api/v1/contacts?accountId=YOUR_ACCOUNT_ID&limit=10" \
  -H "X-API-Key: fmx_your_key_id" \
  -H "Authorization: Bearer your_api_secret"