Send a simulated tracking event to the webhook URLs registered in your account so you can verify that your integration receives and processes tracking status updates correctly.

When to use:
Call this endpoint during development to test your webhook handler before going to production. It triggers a test POST to every active webhook URL configured in your account — no URL is passed in the request body.

Prerequisites:

• Valid JWT authentication token (Bearer)
• At least one active webhook URL registered in your account — webhooks are configured exclusively through the Envia platform UI at Settings → Developers → Webhooks (shipping.envia.com/settings/developers); there is no API endpoint to register or manage webhook URLs
• A valid tracking number from a shipment already generated in your account (the shipment must belong to the authenticated company)

Webhook types available in the platform:

Key behaviors:

• Sends a test POST request to each active webhook URL registered in your account — the URL is not a parameter you pass in the request
• The test payload format matches real production webhooks: { "carrier": "...", "tracking_number": "...", "shipment_status": "..." }
• Returns error code 1125 with message "The company has not webhooks configured" if the account has no active webhooks
• In non-production environments, also updates the shipment's status record in the database
• Use this to validate your webhook handler logic, response codes, and error handling before going live