Search
K
notifications v1

Delete Webhooks Registration

This API is used to delete the registration details for Webhook notifications

delete
https://api.pexa.co.uk/partner/api/notification/v1/notification-registrations/{registrationId}

Path Parameters

registrationIdstringrequired

UUID of the registration

Response

The resource has been deleted

delete/partner/api/notification/v1/notification-registrations/{registrationId}
 

Rotate Webhooks Shared Secret

This API is used to rotate existing shared secret with a new shared secret on the registration id provided for Webhook notifications

post
https://api.pexa.co.uk/partner/api/notification/v1/notification-registrations/{registrationId}/secret-rotation

Path Parameters

registrationIdstringrequired

UUID of the registration

Response

application/json

SUCCESS

New shared secret details, containing shared_secret attribute

expirystringrequired

The time until which the shared secret is valid

Example:2024-02-28T06:12:42Z

sharedSecretstringrequired

The shared secret used to validate the webhook request

Example:38e5d78c-d642-42d1-8064-0082dc87c4e5

post/partner/api/notification/v1/notification-registrations/{registrationId}/secret-rotation
 
application/json

CreateNotificationRegistrationRequest

object

New registration details, not containing the id attribute

webhookURIstringrequired

The secure URI of the webhook to be called when an event occurs (supports only https protocol)

To ensure a smoother integration, avoid using endpoints that end with slashes, as these trailing slashes will be automatically removed from the URI.

Example:https://push-notifications.pexa.com.au/notifications-webhook

eventTypesarray[string]required

Through this field, Integrators have the ability to subscribe to a variety of notification types based on their preferences.

Note: A registration must be created with at least one preferred event type and all mandatory event types for successful registration.

Preferred Webhook Events

  • WORKSPACE_PARTICIPANT_ADDED
  • FINANCIAL_SETTLEMENT_SCHEDULE_PREPARED
  • LODGEMENT_CASE_PREPARED
  • WORKSPACE_PREPARED
  • WORKSPACE_FUNDS_AUTHORISED
  • WORKSPACE_FUNDS_EXCHANGED
  • WORKSPACE_LODGED
  • WORKSPACE_CLOSED
  • WORKSPACE_REQUISITIONED
  • WORKSPACE_CANCELLED

    • Mandatory Webhook Events
  • SECRET_EXPIRY

    • Example:WORKSPACE_PARTICIPANT_ADDED, WORKSPACE_PREPARED, WORKSPACE_LODGED, SECRET_EXPIRY

    Example

    NotificationRegistrationDto

    object

    New registration details, containing id attribute

    webhookURIstringrequired

    The secure URI of the webhook to be called when an event occurs (supports only https protocol)

    Example:https://push-notifications.pexa.com.au/notifications-webhook

    registrationIdstringrequired

    The registration ID returned by create notification registration API

    Example:a12sd23sf4f5f6f9

    subscriberIdstring

    The ID of the subscriber

    Example:123456789

    sharedSecretstring

    The shared secret used to validate the webhook request

    Example:38e5d78c-d642-42d1-8064-0082dc87c4e5

    sharedSecretExpirystring

    The expiry time for current shared secret

    Example:2025-03-13 04:12:51.574000 +00:00

    eventTypesarray[string]

    The list of eventTypes that this registration will send notifications for

    Example:WORKSPACE_PARTICIPANT_ADDED, WORKSPACE_PREPARED, WORKSPACE_LODGED, SECRET_EXPIRY

    Example

    NotificationSecretRotationDto

    object

    New shared secret details, containing shared_secret attribute

    expirystringrequired

    The time until which the shared secret is valid

    Example:2024-02-28T06:12:42Z

    sharedSecretstringrequired

    The shared secret used to validate the webhook request

    Example:38e5d78c-d642-42d1-8064-0082dc87c4e5

    Example