Skip to main content
Get a Webhook Endpoint V2
Usa este endpoint para recuperar un único endpoint de webhook por su ID. La respuesta incluye la URL del endpoint, sus eventos suscritos, su apiVersion y su estado actual. El secreto de firma no forma parte de la respuesta. Solo se devuelve cuando se crea el endpoint, así que si ya no lo tienes, elimina el endpoint y registra un reemplazo para obtener uno nuevo.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

id
string
requerido

Respuesta

The requested webhook endpoint.

apiVersion
string | null
requerido

API version date string this endpoint was configured with, or null if not set.

Ejemplo:

"2026-04-01"

createdAt
string
requerido

ISO 8601 timestamp when the endpoint was created.

Ejemplo:

"2026-01-01T00:00:00.000Z"

description
string | null
requerido

Human-readable description of this webhook endpoint, or null if not set.

Ejemplo:

"Production payment events handler"

id
string
requerido

The unique identifier of the webhook endpoint.

Ejemplo:

"webhook_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"

metadata
any | null
requerido

Arbitrary key-value metadata attached to this endpoint, or null if not set.

Ejemplo:
status
enum<string>
requerido

The current state of this endpoint.

Opciones disponibles:
enabled,
errored,
disabled,
deleted
Ejemplo:

"enabled"

subscribedEvents
enum<string>[]
requerido

List of event types this endpoint receives.

Opciones disponibles:
*,
customer.*,
transfer.*,
document.*,
service.*,
customer.created,
customer.pending,
customer.approved,
customer.rejected,
transfer.created,
transfer.pendingFunding,
transfer.pendingReview,
transfer.fundsReceived,
transfer.processing,
transfer.succeeded,
transfer.returned,
transfer.pendingRefundInformation,
transfer.failed,
transfer.canceled,
transfer.refunded,
transfer.unexpectedError,
transfer.failedPrecondition,
transfer.expired,
transfer.unfunded,
document.pending,
document.processing,
document.verified,
document.rejected,
service.pending,
service.processing,
service.succeeded,
service.failed,
service.cancelled
Ejemplo:
updatedAt
string
requerido

ISO 8601 timestamp when the endpoint was last updated.

Ejemplo:

"2026-01-01T00:00:00.000Z"

url
string
requerido

The HTTPS URL events are delivered to.

Ejemplo:

"https://example.com/webhooks/sphere"

Última modificación el 27 de agosto de 2026