How to Set Up ShipStation Webhooks for Real-Time Shipping Updates in PayHelm

ShipStation webhooks allow PayHelm to receive real-time notifications when orders are shipped, providing you with up-to-date shipping data and improved order tracking capabilities in your analytics dashboard.

What You'll Achieve

After completing this setup, PayHelm will automatically receive notifications from ShipStation when:

• Orders are marked as shipped
• Tracking information becomes available
• Shipping status updates occur

This enables more accurate fulfillment analytics and better customer journey tracking in your PayHelm reports.

Prerequisites

Before setting up ShipStation webhooks, ensure you have:

• An active ShipStation account with admin access
• A PayHelm account with integration permissions
• Your ShipStation API credentials ready

Step 1: Configure Your PayHelm Integration Settings

1. Access Your PayHelm Integrations

• Log into your PayHelm account
• Navigate to the integrations page: https://app.payhelm.com/integrations?search=shipstation
• Look for the ShipStation integration section

2. Add Your Secret Keys

• Locate the ShipStation integration settings
• Enter your ShipStation API credentials as required
• Save your configuration

Important: Make sure your API credentials are properly configured in PayHelm before proceeding to the webhook setup.

Step 2: Create the Webhook in ShipStation

1. Access ShipStation Settings

• Log into your ShipStation account
• Navigate to: https://ship12.shipstation.com/settings/integrations/Webhooks

2. Create a New Webhook

• Click the "Add a Webhook" button
• Configure the webhook with these exact settings:

Webhook Configuration:

• Name: PayHelm
• Event: On Orders Shipped
• URL: https://notifications.payhelm.com/notification/shipstation
• Scope: For All Stores (or select specific stores if needed)

3. Save the Webhook

• Review your settings to ensure they match the requirements above
• Click "Add Webhook" or "Save" to complete the setup

Step 3: Test Your Integration

1. Verify Webhook Status

• In ShipStation, confirm your PayHelm webhook appears in the active webhooks list
• Check that the status shows as active/enabled

2. Test with a Sample Order

• Process a test order through your normal fulfillment workflow
• Mark the order as shipped in ShipStation
• Monitor your PayHelm dashboard for the updated shipping information

Expected Results

Once properly configured, you should see:

• Real-time shipping updates in your PayHelm analytics
• Improved order status tracking in reports
• More accurate fulfillment metrics and timing data
• Enhanced customer journey visibility

Troubleshooting Common Issues

Webhook Not Triggering:

• Verify the webhook URL is exactly: https://notifications.payhelm.com/notification/shipstation
• Ensure the event is set to "On Orders Shipped"
• Check that your PayHelm API credentials are properly configured

Missing Shipping Data:

• Confirm the webhook scope includes the relevant stores
• Verify that orders are being properly marked as shipped in ShipStation
• Allow up to 15 minutes for data to appear in PayHelm after shipping

Authentication Errors:

• Double-check your ShipStation API credentials in PayHelm
• Ensure your ShipStation account has the necessary permissions
• Try re-saving your integration settings in PayHelm

Additional Support

If you continue to experience issues after following these steps:

1. Verify all prerequisites are met
2. Check that both your ShipStation and PayHelm accounts have the necessary permissions
3. Ensure your API credentials are current and properly configured

The webhook integration provides automated, real-time data synchronization between ShipStation and PayHelm, improving the accuracy and timeliness of your shipping analytics.