# Test a webhook subscription by pinging it with a sample payload

More information about testing webhook subscriptions is available on the Testing Webhook Subscriptions page.

Endpoint: POST /v2/webhooks/subscriptions/{subscription_id}/ping
Version: 2026-05-01
Security: oauth2_as_a_server, oauth2_as_a_user

## Security:

  - `oauth2_as_a_server` (unknown)
    oauth2 scopes: webhooks.read

  - `oauth2_as_a_user` (unknown)
    oauth2 scopes: webhooks.read

## Path parameters:

  - `subscription_id` (integer, required)
    Id of the subscription to ping

## Response 200:

  - `200` (unknown)
    Success

## Response 200 fields (application/json):

  - `data` (object)

  - `data.delivery` (object)

  - `data.delivery.id` (string)
    The unique id of the delivery. This value is also provided in the 'X-SocialChorus-Delivery' header of the request made to the subscription's url.
    Example: abc123-456

  - `data.delivery.status` (string)
    A value indicating the status of the delivery and the response we received back when sending the delivery to the subscription's url.
    Enum: "pending", "success", "failure", "retryable"

  - `data.subscription` (object)

  - `data.subscription.id` (string)
    Unique identifier for this subscription.
    Example: abc123

  - `data.subscription.url` (string)
    The url that will be called when delivering events for this subscription.
    Example: https://example.com/webhook

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 401:

  - `401` (unknown)
    Unauthenticated. See more on error responses  here.

## Response 401 fields (*/*):

  - `errors` (array)

  - `errors.code` (integer)
    Example: 401

  - `errors.title` (string)
    Example: Unauthenticated

  - `errors.detail` (string)
    Example: Access token was not provided or not recognized.

## Response 403:

  - `403` (unknown)
    Unauthorized. See more on error responses  here.

## Response 403 fields (*/*):

  - `errors` (array)

  - `errors.code` (integer)
    Example: 403

  - `errors.title` (string)
    Example: Unauthorized

  - `errors.detail` (string)