# 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: v2
Security: oauth2_as_a_server, oauth2_as_a_user

## Path parameters:

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

## 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 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 fields (*/*):

  - `errors` (array)

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

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

  - `errors.detail` (string)