Seamless Donor Portal access

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 “Generate 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. Create a new API key or edit an existing one. Note that 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 and use it. Learn more about getting an API key.
3. Enable the “Generate Donor Portal access links” permission.
   

4. Save changes.

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.

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“ button 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.