Shipment Webhook for ALL shipments

GraphQL API
1

Is it possible to create a shipment webhook that triggers for any shipment, regardless of account_id or shop_name?

2

Hello @jknechtv

Thanks for reaching out!

From a 3PLs perspective, registering it at the 3PL level should trigger for all customer account IDs and all stores.

If this is not true for you, could you share some examples where you did not get an expected Shipment Update Webhook?

Have a great day!
TomasFD

3

Hey @tomasfd, I’ll give that a shot and see if it works.

I’m reviewing the shipment update documentation (Webhooks – Developer Resources | ShipHero) and don’t see anything to designate which account_id the shipment is for. Is the account_id the shipment is for sent in the webhook body? I’m also seeing the deprecated shiphero_id in the example responses. Are these examples up-to-date?

4

I found this thread from a few years ago Determine customer account on Shipment Update webhook - #3 by tomasw

@tomasfd do you know if this feature was ever implemented?

5

Hey @jknechtv,

Thanks for hanging in there!

For the Shipment Update Webhook to fire for all customer accounts and stores it must be registered using a developer user associated with the 3PL. I believe the fields in the example at Webhooks – Developer Resources | ShipHero are up to date. These are the fields I just received from the webhook:

steps.trigger
{2}
context
{15}
event
{5}
fulfillment
{21}
completed:
true
created_at:
2023-07-06 15:58:11
custom_tracking_url:
line_items
[1]
0
{10}
customs_description:
id:
R124D21520291
lot_expiration:
null
lot_id:
null
lot_name:
null
package:
Package #1
quantity:
1
serial_numbers
[0]
shiphero_id:
937160344
sku:
12345678
order_gift_note:
order_number:
R143
order_uuid:
T3JkZXI6MzcyMjI1NTAy
package
{4}
height:
5.12
length:
5.12
weight:
0
width:
5.12
package_number:
1
partner_order_id:
R143
Copy Path
•
Copy Value
shipment_id:
361653276
shipment_uuid:
U2hpcG1lbnQ6MzYxNjUzMjc2
shipping_address
{7}
address1:
15733 Michael Avenue
address2:
address_city:
Saint Albans
address_country:
USA
address_state:
New York
address_zip:
11421
name:
John Gianulli
shipping_carrier:
genericlabel
shipping_method:
genericlabel
total_packages:
1
tracking_number:
Pickup
warehouse:
Primary
warehouse_id:
70405
warehouse_uuid:
V2FyZWhvdXNlOjcwNDA1
webhook_type:
Shipment Update
packages
[1]
0
{11}
box_code:
02
box_id:
0
box_name:
null
height:
5.12
length:
5.12
line_items
[1]
0
{17}
country_of_manufacture:
US
customs_description:
customs_value:
0
ignore_on_customs:
false
line_item_id:
937160344
lot_expiration:
lot_id:
null
lot_name:
null
partner_line_item_id:
R124D21520291
price:
20
product_customs_value:
5
product_name:
product23
product_value:
0
quantity:
1
sku:
12345678
tariff_code:
0
weight:
0
name:
Package #1
shipping_address
{7}
address1:
15733 Michael Avenue
address2:
address_city:
Saint Albans
address_country:
USA
address_state:
New York
address_zip:
11421
name:
John Gianulli
shipping_label
{6}
cost:
0
shipping_carrier:
genericlabel
shipping_method:
genericlabel
shipping_name:
test
tracking_number:
tracking_url:
https://www.google.com/search?q=
weight_in_oz:
0
width:
5.12
test:
0
total_packages:
1
webhook_type:
Shipment Update

I’ll double check about that feature and get back to you.

Please let me know if you have any questions or concerns.

Best,
RayanP