Skip to main content

Test webhook subscription

POST /webhook-subscriptions/{id}/test

Requires webhooks:write, public API access and webhook access for the organisation.

Authorization​

X-API-Key required

Parameters​

NameLocationTypeRequiredDescription
idpathstringYesRemyPass resource _id

Request Body​

FieldTypeRequiredLimitsDescription
eventscan.created, member.created, member.updated, member.status_changed, member.deleted, membership.created, membership.updated, membership.activated, membership.renewed, membership.expiring, membership.expired, membership.cancellation_scheduled, membership.cancellation_revoked, membership.cancelled, membership.payment_succeeded, membership.payment_failed, membership.refund_created, membership.refund_succeeded, membership.refund_failed, membership_type.created, membership_type.updated, membership_type.archived, membership_type.deleted, event.created, event.updated, event.published, event.unpublished, event.visibility_changed, event.cancelled, event.deleted, event_registration.created, event_registration.confirmed, event_registration.updated, event_registration.cancelled, event_registration.checked_in, event_order.created, event_order.confirmed, event_order.cancelled, event_order.payment_succeeded, event_order.payment_failed, event_order.refund_created, event_order.refund_succeeded, event_order.refund_failed, donation.created, donation.payment_succeeded, donation.payment_failed, donation.refund_created, donation.refund_succeeded, donation.refund_failed, donation.dispute_opened, donation.dispute_closed, donation_subscription.created, donation_subscription.activated, donation_subscription.updated, donation_subscription.past_due, donation_subscription.cancellation_scheduled, donation_subscription.cancellation_revoked, donation_subscription.cancelled, donation_campaign.created, donation_campaign.updated, donation_campaign.published, donation_campaign.unpublished, donation_campaign.deletedYes

The subscription must be active. Any supported event can be tested, including events outside its selection. The payload has test: true and source: api. A 202 response means queued, not delivered; inspect delivery history for the outcome.

Request Examples​

curl -X POST "https://api.remypass.com/api/v1/public/webhook-subscriptions/507f1f77bcf86cd799439011/test" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "event": "member.created"
}'

Responses​

StatusDescription
202Synthetic delivery queued
400Bad request. The top-level message explains what is invalid and, where applicable, the errors array contains structured field details.
401Missing or invalid API key.
403The caller is not allowed to access this resource.
404Resource not found.
429Rate limit exceeded.
500Server error.

202 Response Example​

{
"success": true,
"message": "Success",
"data": {
"id": "evt_example",
"event": "member.created",
"timestamp": "2026-10-06T12:00:00.000Z",
"organisation_id": "507f1f77bcf86cd799439011",
"schema_version": "1",
"source": "api",
"test": true,
"data": {
"member": {
"id": "507f1f77bcf86cd799439011",
"company": "507f1f77bcf86cd799439010",
"memberId": "MEM001",
"name": "Example Member",
"email": "member@example.com",
"status": "active"
}
}
}
}

Response Fields​

FieldTypeDescriptionAttributes
successboolean
messagestring
dataobject
Show child attributes
  • id: string — Stable event ID reused for retries and replay; may be a SHA-256 hash or UUID
  • event: scan.created, member.created, member.updated, member.status_changed, member.deleted, membership.created, membership.updated, membership.activated, membership.renewed, membership.expiring, membership.expired, membership.cancellation_scheduled, membership.cancellation_revoked, membership.cancelled, membership.payment_succeeded, membership.payment_failed, membership.refund_created, membership.refund_succeeded, membership.refund_failed, membership_type.created, membership_type.updated, membership_type.archived, membership_type.deleted, event.created, event.updated, event.published, event.unpublished, event.visibility_changed, event.cancelled, event.deleted, event_registration.created, event_registration.confirmed, event_registration.updated, event_registration.cancelled, event_registration.checked_in, event_order.created, event_order.confirmed, event_order.cancelled, event_order.payment_succeeded, event_order.payment_failed, event_order.refund_created, event_order.refund_succeeded, event_order.refund_failed, donation.created, donation.payment_succeeded, donation.payment_failed, donation.refund_created, donation.refund_succeeded, donation.refund_failed, donation.dispute_opened, donation.dispute_closed, donation_subscription.created, donation_subscription.activated, donation_subscription.updated, donation_subscription.past_due, donation_subscription.cancellation_scheduled, donation_subscription.cancellation_revoked, donation_subscription.cancelled, donation_campaign.created, donation_campaign.updated, donation_campaign.published, donation_campaign.unpublished, donation_campaign.deleted
  • timestamp: string (date-time)
  • organisation_id: string
  • schema_version: 1
  • source: string — Origin of the event
  • test: boolean
  • data: object — Event-specific data; consult the catalogue samples