Webhook Integration

Develop, Build & Integrate APIs & Integrations
1

Hi team,

I need to get advices from developers using Hubspot that when getting the data record of pipeline through API Webhook, How can I do it while body json of Hubspot only give me like this below

{
“eventId”: 220013470,
“subscriptionId”: 3024697,
“portalId”: 44324961,
“appId”: 5170374,
“occurredAt”: 1755681660000,
“subscriptionType”: “ticket.propertyChange”,
“attemptNumber”: 0,
“objectId”: 131132985037,
“propertyName”: “hs_pipeline”,
“propertyValue”: “722397713”,
“changeSource”: “CONVERSATIONS”
}

2

Hi @Chou_Hai :waving_hand: Thanks for the great question. I think this is a common issue devs run into when working with webhooks. I have a few thoughts, but I’d like to ask some of our community experts first — hey @GiantFocal @MichaelMa @SteveHTM how do you handle this type of issue with webhook payloads? — Jaycee

3

Hi Jaycee_Lewis,

Sound looks great! Let me give your more information about that.

I have created the webhook to sync data from hubspot to my internal system called data hub

Chou_Hai_0-1755744775043.png
Chou_Hai_0-1755744775043.png1606×741 73.6 KB

However, what I need to have more is when this event hs_pipeline_stage changed, Hubspot will send Body Json data to my data hub included “pipeline” in payload to separate that data changed from which one?

Chou_Hai_1-1755745207082.png
Chou_Hai_1-1755745207082.png335×658 60.6 KB

So I don’t know the way to connect with dev of hubspot to give it.

4

Hey, @Chou_Hai :waving_hand: Thanks for the details. I double-checked the Webhook docs and there are not any instructions or indication that we can augment the payload. My thought is you’ll need to make some combo of your webhook and API calls to fill in the blanks.

Other considerations:

  • Cache pipeline data - fetch pipeline definitions once and cache them
  • Batch API calls where possible - if you get multiple webhooks, batch the API requests
  • Error handling - to handle cases where the API call fails
  • Rate limits - be careful of any API rate limits

Talk soon! — Jaycee

5

Hi Jaycee_Lewis,

I’m so greatful for your suggestion and share

Let me try to find the way with it.

Regards,

6

Hello @Chou_Hai and @Jaycee_Lewis

My approach is to use the information in the webhook to get everything through API calls.
Example:

1. Receive the webhook call

2. Validate headers etc.

3. Get a list of events included in the request as you can have more then one event in the request

4. Loop over each event

5. Process event
Processing for SubscriptionEvent:

1. Check event ChangeFlagValue

2. Handle selected or all cases Created/New/Updated/Deleted

3. Cases created/New

3.1 GetSubscription (/crm/v3/objects/subscriptions/)

3.2 GetLineItemIds (/crm/v3/objects/subscriptions/{subscriptionId}/associations/line_items)

3.3 GetAssociatedContacts (/crm/v3/objects/subscriptions/{subscriptionId}/associations/contact)

3…

4. Process the information in my application

5. Return (if you processing is ‘too long’ consider putting into queue and return 204 to prevent HubSpot from marking the webhook call as failed)