Raisely charges a small fee per API call. Refer to Raisely's pricing documentation for current API costs.
The Raisely integration allows Vega to automatically create or update contacts and import donations from your Raisely campaigns.
Two integration methods are available:
- Raisely Webhooks – automatically sends new donations and profile updates to Vega in real time.
- Raisely API Import – manually imports donations from Raisely for a selected date range.
Both methods are configured from:
Admin → External Webhooks and APIs
Choosing an Integration Method
| Method | Best For |
|---|---|
| Webhooks | Automatically importing donations and fundraiser updates as they occur. |
| API Import | Importing historical donations or manually retrieving transactions for a specific date range. |
Setting Up Raisely Webhooks
Step 1 – Create a Webhook in Vega
Navigate to:
Admin → External Webhooks and APIs → Raisely Webhooks
Raisely Webhooks
Click Add Web Hook.
Complete the following fields:
| Field | Description |
|---|---|
| Webhook Name | A descriptive name for the connection (usually the campaign name). |
| Centres (Optional) | Select a Centre or Donation Centre if applicable. |
| Campaign | The Vega campaign that imported donations will be associated with. An External List campaign is commonly used. |
| Raisely Campaign Code | Enter the Campaign UUID from Raisely. |
| Secret Key (Optional) | Generate a shared secret key for additional security. Although optional in Raisely, this is recommended, particularly when sharing campaigns across multiple organisations or branches. |
Click Add to save the webhook.
Once created, map the required GL Codes and Contact Types.
Step 2 – Configure the Webhook in Raisely
In Raisely:
- Open the required campaign.
- Go to Settings → API & Webhooks → Webhooks.
- Click Add Webhook.
- Subscribe to the following events:
- Donation Succeeded
- Profile Created (Peer-to-Peer campaigns only)
- Profile Updated (Peer-to-Peer campaigns only)
Note
A separate webhook must be configured for each Raisely campaign you wish to connect to Vega.
Setting Up a Raisely API Import
Step 1 – Create an API Connection
Navigate to:
Admin → External Webhooks and APIs → Raisely API Import
Click Add API Import.
Complete the following fields:
Note
A separate API connection is required for each Raisely campaign.
| Field | Description |
|---|---|
| API Name | A descriptive name for the connection. |
| Centres (Optional) | Select a Centre or Donation Centre if required. |
| Campaign | Select the Vega campaign that imported donations should be linked to. |
| Raisely Campaign Code | Enter the Campaign UUID from Raisely. |
| API Key | Enter the API Key generated in Raisely. |
Click Add.
Map the required GL Codes and Contact Types.
Note
A separate API connection is required for each Raisely campaign.
Step 2 – Obtain Your API Key
In Raisely:
- Open the required campaign.
- Navigate to Settings → API & Webhooks → API Keys.
- Copy the campaign API Key into Vega.
Step 3 – Import Data
Navigate to:
Money → Webhooks and API Log
Click Import from API.
Select:
- the required API connection
- a From date
- a To date
Click Import.
Note
Large imports may take several minutes to complete.
Viewing Imported Data
All imported webhook and API activity can be viewed from:
Money → Webhooks and API Log
Depending on the event received, the source will display as:
- Raisely Donation
- Raisely Contact Update
- Raisely Profile Update
Because these records originate from Raisely, they do not contain a Widget ID or Widget Name.
Contact Matching
When data is received from Raisely:
- Vega first attempts to match the contact using existing records.
- If no match is found, a new contact is created.
- An External ID is stored against the contact to ensure future updates are matched correctly.
Peer-to-Peer Fundraisers
For Peer-to-Peer campaigns, Vega stores additional fundraiser information under Peer-to-Peer Details on the Contact Dashboard, including:
- Campaign Name
- Campaign Description
- Raisely URL Path
- Fundraising Target
- Team Name
If the fundraiser belongs to a team:
- a Team contact is created automatically
- the fundraiser is linked using the Team Member relationship
Donations received through Peer-to-Peer campaigns are imported as Supporter-Led Payments, including:
- fundraiser
- team
- supporter message (stored in Pay Details)
|
Profile Field Mapping
Donation Field Mapping
|
Related article: Raisely Attribute Filtering and Mapping
“Some content in this article may have been developed with the assistance of AI tools and reviewed by staff.”
Comments
0 comments
Please sign in to leave a comment.