Webhooks

Pathfix Automation has pre-configured webhook connections to a few providers, this makes it easy for you to be able to connect, start listening for webhook events for each provider and add the integration to your platform.

Important Note Webhoooks listening for end-user integrations works only for authentication done via Pathfix OAuth



Activating Webhooks

Make sure you have added the provider integration in your Pathfix OAuth account first before proceeding. Here is the documentation for Pathfix OAuth platform.

Intro

Once a webhook has been configured, you can trigger any Pathfix automation built. Alternatively, you can also trigger your own endpoint to perform a function of your choice.

We recommend building your automation first (what you want to do after a webhook data is received) and then move to activate the Webhook.

Enable Webhook

  • Click on Webhooks from the top nav bar
  • From the list of providers, select the provider you wish to work with
Image: Webhook activation
Image: Webhook activation



  • In the General tab, enter the Callback URL that the Webhook system should call once the data is received. This could either be:
    • the endpoint of a Pathfix Automation (reference image below), or
    • your own internal endpoint
Image: Pathfix Automation endpoint
Image: Pathfix Automation endpoint



  • The next fields will define any provider-specific requirements. Each provider has a different webhook requirement and differs from provider to provider. Please make sure you check the notes under each item for details



Image: Provider specific setting
Image: Provider specific setting



  • Click on Pathfix OAuth tab
  • Enter your Pathfix Public Key and Private Key (get this from your Pathfix OAuth platform -> Application - Keys)
  • Click on the Webhook URI section and copy the Webhook URI. This is the webhook/Callback URL to enable your webhook with the provider
  • Go to the developer portal of the selected provider and enter the Webhook URL under the Webhook/Callback URL section
  • Click on Save to save
  • Pathfix Automation will validate the webhook and register it for each of your connected user



Image: OAuth setup
Image: OAuth setup



Status and Users

  • Once successfully setup, you will see:
    • Status against the activated webhook (Green or Red)
    • Total number of users that have subscribed to the webhook
    • Option to Deactivate the webhook



Image: Webhook status
Image: Webhook status



  • To view details of the users connected, click on the Subscribed Users count
  • You will see a list of all connected users
Image: Connected users
Image: Connected users



  • If there are any failures against a user, click on the refresh icon and the webhook will try to re-register the user automatically
Image: Failed reconnection
Image: Failed reconnection







Need help? You can always reach out to our support team for any additional assistance at support@pathfix.com.