---
title: "Fire a test event at your endpoint"
method: POST
path: "/webhooks/test"
tags: ["Webhooks"]
---

# Fire a test event at your endpoint

`POST /webhooks/test`

## Request

- Base URL: `https://api.socially.run/v1`
- URL: `https://api.socially.run/v1/webhooks/test`
- Auth: HTTP bearer

Send a `ping` event to your registered endpoint right now and wait for the answer, so you can verify the URL and your signature check without waiting for a real job. The result is the actual outcome: `ok: false` carries the HTTP status your server answered, or why we could not reach it. A ping that lands also revives an endpoint we had auto-disabled. It never retries, and it does not count against the failure streak of a real event. Free.

## Response `200`

Fire a test event at your endpoint

- object
  - `data` unknown, required

## Other responses

- `400`: VALIDATION_ERROR / INVALID_TARGET / SSRF_BLOCKED: the issues, never the values.
- `401`: UNAUTHORIZED / INVALID_TOKEN: the key is missing or wrong.
- `402`: PAYMENT_REQUIRED / PLAN_GATE: clears by upgrading or buying credits, never by waiting.
- `429`: RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED: Retry-After says when it clears.
- `default`: Any other failure.

---

[API](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json.md) · [All operations](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json/llms.txt) · [OpenAPI document](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json/revisions/5a0b24534b90?raw)