Webhook Events
  • 14 Feb 2024
  • 2 Minutes to read
  • Dark

Webhook Events

  • Dark

Article Summary


Anytime records are updated (CRUD - created/updated/deleted) in Stripe, a Webhook Event record in Salesforce gets created. Each Webhook Event record contains the full Stripe JSON payload of what occurred, which is processed in Salesforce by an scheduled batch job that processes new records every 5 minutes. This batch job will parse the Webhook Event details and use the data to insert or update the related record in Salesforce.

For example, if a Payment Method was updated in Stripe, a Webhook Event is created in Salesforce and the batch job will update the Payment Method record in Salesforce.

Another scheduled batch job will delete processed Webhook Event records to limit record storage in your Org. The Retain Webhook Records for (Days)" in Blackthorn | Payments Triggers field controls how long to keep processed records. The default value is 30 - if you set the value to blank it will not delete any processed records.

We suggest using Webhook Events for troubleshooting and/or tracking what records are created or have been updated in Salesforce. This object only captures data from Stripe, it does not send information back to Stripe. Updating or creating Webhook Events in Salesforce will not create and/or update records in Stripe.

Note: You must configure webhooks before Webhook Events can be created.

Stripe Webhook

How to navigate to Webhook Events in Stripe.

  • Navigate to your Stripe dashboard.
  • On the left-hand side, click on "Events and Logs".
    This is where you will see all Webhook Events.
  • Click on any record.
  • The event record is split into Event Details, Event Data, and Webhooks.

H_01_13_Stripe Webhook

All of this information is pushed to Salesforce through Stripe's Webhook. Stripe pushes Webhook Events to Salesforce in random order, such as the Payment data may get pushed before the Customer data, so we place all of these records in the Webhook Event object to process as a batch to mitigate Stripe's unpredictable lack of chronological order. Technically, you first need a Stripe Customer, then a Payment Method, then a Transaction, thus the purpose of the Webhook Event (to mitigate this randomness and process in the order Salesforce needs).

Salesforce Webhook Event

How to navigate to the Webhook Event object in Salesforce.

  • Navigate to the Webhook Events object.

Lightning: Click on the App Launcher | Under "All Items" | Click on Webhook Events.

Classic: Click on "All Tabs" ("+" icon in the top right) | Click on Webhook Events.

  • Click on any record.

H_01_13_SF Webhook Event

Manually Process a Webhook Event record

If you want to manually process the record...

Click the "Process" button at the top of the page (classic user interface) or click the down arrow in the upper right-hand corner and click "Process" (lightning user interface).

For example, if you are testing and need to process the data faster than every 5 minutes, you would want to manually "Process" the Webhook Event record.


If you have received an error with any Webhook Event record or have a question, please view our Troubleshooting page.