---
title: "Send test webhook action"
method: POST
path: "/webhooks/{webhook_id}/test"
tags: ["webhooks"]
---

# Send test webhook action

`POST /webhooks/{webhook_id}/test`

## Path parameters

- `webhook_id` string, required

## Request body

- TestWebhookRequestBody
  - `request_type` 'subscription.trial.ended' | 'company.created' | 'company.deleted' | 'company.override.created' | 'company.override.deleted' | 'company.override.expired' | 'company.override.updated' | 'company.plan_changed' | 'company.scheduled_downgrade' | 'company.updated' | 'credit.limit.reached' | 'credit.limit.warning' | 'credit.purchase.success' | 'entitlement.limit.reached' | 'entitlement.limit.warning' | 'entitlement.soft_limit.reached' | 'entitlement.soft_limit.warning' | 'entitlement.tier_limit.reached' | 'entitlement.tier_limit.warning' | 'feature.created' | 'feature.deleted' | 'feature.updated' | 'flag.created' | 'flag.deleted' | 'flag_rules.updated' | 'flag.updated' | 'plan.created' | 'plan.deleted' | 'plan.entitlement.created' | 'plan.entitlement.deleted' | 'plan.entitlement.updated' | 'plan.updated' | 'plan_version.deleted' | 'rule.deleted' | 'test.send' | 'user.created' | 'user.deleted' | 'user.updated' | 'auto.topup.hard.failure' | 'auto.topup.retry.exceeded' | 'auto.topup.success', required

## Response `200`

OK

- object
  - `data` TestWebhookResponseData, required
    - `response_code` integer, required
    - `success` boolean, required
  - `params` object, required — Input parameters

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Server error

---

[API](https://skmtc.net/schematichq/apis/schematic-api.md) · [All operations](https://skmtc.net/schematichq/apis/schematic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/schematichq/schematic-api/versions/873fb318b08a/schema)