This guide shows you how to send real-time events from Shopmonkey to OktoRocket using a webhook URL. After setup, Shopmonkey will notify OktoRocket whenever key records are created or updated (orders, payments, customers, vehicles, appointments, messages, and more).
Webhook URL you will paste into Shopmonkey
Template with placeholders (copy this if you want to paste first and replace later):
Before you start
You can sign in to your Shopmonkey account.
You have access to Settings → Webhooks.
OktoRocket Support sent you your tenantId and shopId.
(Recommended) Decide a Shared Secret with OktoRocket Support to verify deliveries.
Step 1 — Open Webhooks in Shopmonkey
Sign in to Shopmonkey.
Go to Settings → Webhooks.
Click New Webhook.
Step 2 — Create the webhook
Name: OktoRocket – Event Stream (or any name you prefer)
URL: paste the webhook URL from above (with your tenantId and shopId).
Events to send: start with the essentials; you can add more later:Order
Payment
Customer
Vehicle
Appointment
Message
Secret: add a Shared Secret if available (recommended). Keep this private.
Save and make sure the webhook is Enabled.
Tip: If you manage multiple locations, you can set up separate webhooks per location or use location-specific settings in Shopmonkey if available.
Step 3 — Test that it works
In Shopmonkey’s webhook screen, click Send/Test (or similar) to send a sample event.
Alternatively, make a small change in Shopmonkey (for example, create a test order or payment).
Confirm the webhook shows a successful delivery (status 200 or 202).
Troubleshooting
If something isn’t working, check these quick fixes:
Webhook disabled: If deliveries fail repeatedly, Shopmonkey may disable the webhook. Re-enable it after fixing the URL or secret.
Wrong IDs: Double-check your tenantId and shopId. If needed, contact OktoRocket Support.
No events arriving: Verify the webhook is Enabled and click Send/Test from the webhook page.
Multiple locations: Consider separate webhooks per location for clean reporting.
Need help?
Contact OktoRocket Support. Provide your account email, the time of the last test you tried, and a screenshot of your webhook settings if possible.