---
title: "Test a Webhook Endpoint"
method: POST
path: "/ship/webhooktest/"
tags: ["Webhooks"]
---

# Test a Webhook Endpoint

`POST /ship/webhooktest/`

Send a simulated tracking event to your registered webhooks

## Request body

- object
  - `carrier` string, required — Carrier name from the shipment (e.g. `fedex`, `dhl`, `estafeta`). Must match the carrier of the shipment associated with the provided tracking number.
  - `trackingNumber` string, required — Tracking number of a shipment previously generated in your account. The shipment must belong to the authenticated company.
  - `status` 'Shipped' | 'Delivered' | 'Canceled' | 'Picked Up', required — Status name to simulate. Accepted values: `Delivered`, `Shipped`, `Canceled`, `Picked Up`. These values also update the shipment's status record in non-production environments.

## Response `200`

Webhook test triggered successfully

- object
  - `meta` string — Action name — always `webhookTest` for this endpoint
  - `data` object
    - `message` string — Result message

## Other responses

- `422` — No active webhooks configured or shipment not found

---

[API](https://skmtc.net/envia/apis/envia-shipping-api-complete-documentation.md) · [All operations](https://skmtc.net/envia/apis/envia-shipping-api-complete-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/envia/envia-shipping-api-complete-documentation/revisions/39f9208959d6/schema)