Integrate Fundraise Up Donor Portal with your platform

The API provides two types of authentication links:

1. Full Donor Portal access link:
   • Provides your supporters full access to their Fundraise Up Donor Portal without requiring them to log in.
   • Allows supporters to manage all their donations and account settings.

   Requires supporter ID to generate.

2. Single recurring plan access link in Donor Portal.
   • Provides your supporters direct access to a specific recurring plan in their Fundraise Up Donor Portal without requiring them to log in.
   • Includes an option to specify a return URL to your portal.

   Requires recurring donation ID to generate.

Access links are generated through our API endpoints. These endpoints check permissions and validate parameters to ensure secure access.

• An API key with the “Donor Portal access links” permission enabled.
• Supporter ID (for full portal access) or recurring donation ID (for subscription management).

How to create an API key

1. Go to Dashboard > Settings > API keys.
2. Click Create API key.
   Parent accounts cannot use their API keys to create access links for subaccounts. To create access links for a subaccount, generate an API key within that specific subaccount.
3. Enter a descriptive name for your API key. This name helps you identify different keys when you have multiple integrations.
4. Check the Donor Portal access links checkbox.
5. Click Create API key.

Endpoint: POST https://api.fundraiseup.com/v1/donor_portal/access_links/supporters/:id

This endpoint generates a link that allows a specific supporter to access their Fundraise Up Donor Portal page without logging in.

Path parameter:

• id — Supporter ID (required)

Response

1{
2	"url": "https://ropsi.org/login/?auth=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImlkIjoiNjRiMGJhOWQ5YTE5ZWEwMDFmYTM1MTZhIiwiaWRlbXBvdGVuY3lLZXkiOiIwMDg0YzJkZGZhMGNhZGJhODAwOWI2M2M0MTVhZWZhOGQ0YWYxMjJjZjg3ZmE3ODNmN2ZlNWE5YmVjMzQxNGQzIiwicGF0aCI6Ii9yZWN1cnJpbmdzL1JWRUJXSkJMIn0sImlhdCI6MTcyOTA4MTg2M30.7QTIc9Qvbql642MMvsnrAgVLG3Bj77bCY4yirPAUNXU"
3}

Endpoint: POST https://api.fundraiseup.com/v1/donor_portal/access_links/recurring_plans/:id

This endpoint generates a link that allows a supporter to view and edit a specific recurring plan. Access to other sections of the Fundraise Up Donor Portal is restricted.

Recurring donation page in Donor Portal with “← Back to Home” link

Path parameter:

• id — Recurring plan ID (required)

Parameter:

• back_url string optional

  Must be a valid URL starting with http:// or https://. If invalid, returns 400 Bad Request error.

  If provided, this URL will appear as the “← Back to Home” link in the Fundraise Up Donor Portal. The supporter can click this link or the portal logo to return to your organization's portal.

  If not provided, the “← Back to Home“ link will not be displayed and the portal logo will not be clickable.

  We recommend including a return URL to provide consistent navigation between portals.

Response

1{
2	"url": "https://ropsi.org/login/?auth=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImlkIjoiNjRiMGJhOWQ5YTE5ZWEwMDFmYTM1MTZhIiwiaWRlbXBvdGVuY3lLZXkiOiIwMDg0YzJkZGZhMGNhZGJhODAwOWI2M2M0MTVhZWZhOGQ0YWYxMjJjZjg3ZmE3ODNmN2ZlNWE5YmVjMzQxNGQzIiwicGF0aCI6Ii9yZWN1cnJpbmdzL1JWRUJXSkJMIn0sImlhdCI6MTcyOTA4MTg2M30.7QTIc9Qvbql642MMvsnrAgVLG3Bj77bCY4yirPAUNXU"
3}

Access links are valid for 1 minute after they are generated and must be used immediately. We strongly recommend implementing an automatic redirect to take supporters directly to their Fundraise Up Donor Portal without requiring manual action.

These links are intended solely for use within the Donor Portal and should not be shared through emails, notifications, or any other channels. They provide access to sensitive supporter data and financial information, including:

• Managing subscription amounts and payment methods.
• Viewing donation receipts.
• Reviewing donation history.

To protect supporter privacy, validate the ownership of the supporter or donation before generating a link. Ensuring proper use and secure handling of these links minimizes the risk of unauthorized access.