---
title: "POST /v1/origin/app/webhook/pings"
method: POST
path: "/v1/origin/app/webhook/pings"
tags: ["OriginService"]
---

# POST /v1/origin/app/webhook/pings

`POST /v1/origin/app/webhook/pings`

## Request

- Base URL: `https://api.cursor.com`
- URL: `https://api.cursor.com/v1/origin/app/webhook/pings`
- Auth: HTTP bearer

Sends a synthetic `ping` test delivery to the authenticated app's
 configured webhook URL and reports the receiver's response, so a
 receiver can be verified during setup without waiting for a real event.

 The ping is signed exactly like production deliveries, with event type
 `ping` and a payload identifying the app. Its `webhook-signature` header
 carries a `v1ed` Ed25519 signature over the lowercase hex SHA-256 digest
 of `{webhook-id}.{webhook-timestamp}.{body}`; verify it against
 `/v1/origin/keys`. The header names follow Standard Webhooks, but
 Standard Webhooks libraries do not verify this signature. It is sent
 once, synchronously, with no retries, and does not appear in
 ListWebhookDeliveries. Requires a configured webhook URL; rejected with
 FAILED_PRECONDITION otherwise.

## Request body

- PingWebhookRequest

## Response `200`

OK

- PingWebhookResponse
  - `deliveryId` string: The `webhook-id` header value of the test delivery.
  - `eventId` string: Event id inside the signed envelope (`event.id`).
  - `delivered` boolean: True when the receiver answered with a 2xx status within the delivery timeout. Always present in JSON responses (explicit presence keeps `false` from being omitted as a proto3 default).
  - `responseStatusCode` integer: HTTP status the receiver answered with; 0 when no response arrived (connection failure or timeout). Always present in JSON responses.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `default`: Default error response

---

[API](https://skmtc.dev/cursor/apis/cursor-origin-api.md) - [All operations](https://skmtc.dev/cursor/apis/cursor-origin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cursor/apis/cursor-origin-api/revisions/cbc1547d6ef7?raw)