Skip to main content
Webhooks (Events) in Stockcrowd

Send Events from Stockcrowd to your Third Party tool using our Webhooks, and get real time notifications about your Campaigns!

Juan Yanez avatar
Written by Juan Yanez
Updated over 8 months ago

6.3. Logs


1. What are Webhooks?

❗️This feature requires technical implementation. If you need to create an integration, we recommend sending this article to the person who manages your System or (IT).

Webhooks are events that trigger actions. They allow different programs on the Internet to send information to each other in real-time.

Webhooks are triggered when a specific event takes place hence they are also commonly known as Events.

This is the easiest way of receiving a notification when something relevant happens in within two different systems, from your Stockcrowd Account environment to a CRM.

2. Webhooks in Stockcrowd

❗️The type of coding for any event is UTF-8.

Each time an event occurs, we can send information to your Organisation in one of two ways:

  1. Send a notification to your Email,

  2. Post them to a URL defined by you.

The data that we send depends on the type of event that occurred.

To set up an event, you must:

  1. Select the type of event to be set.

  2. Set up the Notification method (Email or URL).

  3. Activate the Event.

Once the Webhook is set, Stockcrowd will send notifications every time this event is triggered, posting the relevant data in the URL or email.

3. Event Types in Stockcrowd

Stockcrowd has the following Event types available:

Event type

Description

INVERSOR_CREATED

User registration completed

INVERSOR_PAYMENT_CREATED

A payment request has been created

INVERSOR_PAYMENT_SUCCEEDED

Payment request confirmed

RECOMPENSA_SOLD

Data of a reward associated with a successful payment

BLACKBAUD_TOKENIZATION

Fundraising using BLACKBAUD in tokenization mode

SIGNATURE_CREATED

Signature collection record associated with a campaign

CAMPAIGN_ACTIVATED

Campaign Activation

INVERSOR_PAYMENT_REFUND

Return of the confirmed request

INVERSOR_PAYMENT_SUBSCRIPTION_CANCELLED

Recurring Charge Subscription Cancellation

INVERSOR_PAYMENT_SUBSCRIPTION_CHANGED

Recurring Charge Subscription Changes

RECURRING_CHARGE_CREATED

Recurring charge created

INVERSOR_PAYMENT_SUBSCRIPTION_FAILED

Failed payment on recurring subscription charge

P2P_CAMPAIGN_CREATED

Campaign challenge created

P2P_CAMPAIGN_UPDATED

Updated campaign challenge

P2P_CAMPAIGN_APPROVED

Campaign challenge approved

INVERSOR_PAYMENT_ABANDONED

Abandoned payment

👉 For more information on how to set the events, please check the Company (Organization) > Notifications section of your Account, and select the Event Type you wish to set up.

4. How to set up a Webhook

You can set up Webhooks from Organisation > Notifications;

You will see the list of events available in this section.

Select the type of Event for which you want to receive information to see more details and to open more options in settings:

1. Clicking on the Event Fields icon

Upon opening more options, you will see a section detailing the data you will receive for each event and in which format.

If you have added Custom Fields to your campaigns, then these will also be added to your Events.

5. Set up the notification via URL or email

1. Select the Event you want to set up.

2. Select the icon in the Subscribers column.

A pop-up window will open to view information on already created subscriptions if you have them, and you'll also see an 'add' button for a new one."

Once you have clicked on 'add', you will see the next screen where you can choose from the following options:

  1. Receive notifications for all Campaigns or just a specific one, and

  2. Where you want to send the data (Email or URL)

  3. Activate the subscription when it is ready

  4. Skip sending events when they are offline contributions. Click here to learn more about offline contributions.

  5. Skip sending events when it is a CRM transaction. Click here to learn more about CRM transactions.

  6. It will send events from operations carried out in the campaign before creating the subscription."

In the case of a URL, your IT team will need to set up the URL to which you wish for us to post the information. They can also choose to enable an API key for authentication and select the format.

Apart from configuring this in Stockcrowd, your IT team will also need to make the configurations in your CRM Software where you want to receive the information via URL.

👉 We recommend following the Fields > Event Validation section instructions to configure and test the Webhook.

6. Manage your Webhooks

6.1. Registered Subscriptions

Once you have set up a Webhook, You can see Registered Subscriptions in Subscribers..

In this section, you can view and manage all the Webhooks you have configured for this particular event.

If you need to make changes to a defined Webhook, select the icon in the Options column:

6. Current Events

Find all your sent Webhooks by accessing the event from its name or through the eye icon:

You can check the dispatches there and even resend a message if interested.

To resend a message, click on the aeroplane icon.

6.3. Event History (Logs)

Please look over the history of an event. Once you have accessed the sent messages, you can see the available options in the gear icon.

  • Data - Information sent in the event

  • HTTP logs - Logs from when the information is sent to a URL

  • Errors - Error messages when the event has not been sent. In case of a failure in the event delivery, the system will retry sending every 24 hours for a total of three attempts.

Did this answer your question?