Developer Documentation

API Authentication Guide

Authenticate with the FundraiserMax API using an API key ID and a bearer secret. 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"