Nintex Automation for SharePoint Webhooks Events

From Nintex Automation (5.7) onwards there are two different apps for SharePoint. The legacy Nintex K2 for SharePoint: used for SharePoint on-premises and upgraded environments for SharePoint Online, and Nintex Automation for SharePoint: used on new installations for SharePoint Online.

For Nintex Automation for SharePoint in SharePoint Online, the event receiver now functions using Webhooks. Webhooks is a modern web integration scheme to allow third party services to receive notifications when an event occurs in the source system. This allows Nintex Automation to receive notifications instead of having to poll at regular intervals to find out if something has changed. Webhooks are not SharePoint specific and more web services are supporting Webhooks in general to allow system integration.

SharePoint raises Webhook events asynchronously. Workflows may start out of order or with a time delay based on SharePoint queuing. Typically this is around one minute, but may be as great as five minutes.

Troubleshooting

The following Designer actions are currently not supported:

SharePoint > Document Library:

  • Check in Document

  • Check out Document

  • Discard Document Check Out

SharePoint Online workflow events

If you have issues with Nintex Automation for SharePoint workflow events, make sure the Webhook URL for the list is subscribed by SharePoint and is publicly accessible:

  1. Run the SmartObject Service Tester tool. This can typically be found in C:\Program Files\K2\Bin.

  2. Run the Get Webhooks Subscriptions SmartObject method.

    • System > SharePoint 2013 Integration > SharePoint Integration Helper Methods > Methods > Get Webhooks Subscriptions.
  3. Enter the SharePoint Site URL and a List Title.
  4. Execute the SmartObject.
  5. Verify the NotificationURL result contains the K2 Server SharePoint Webhook Endpoint URL.

If the K2 Server SharePoint Webhook Endpoint URL does not exist:

  1. Edit your workflow, and rerun the Start Event configuration to re-subscribe the Webhook or Update URL.

  2. Re-deploy your workflow.

  3. Verify that the Webhook URL is accessible from public internet using the steps above. SharePoint validates this URL during the re-subscribe.

SharePoint Online workflows not starting

If your workflows are not starting, use the following steps:

  1. Open the Windows Event Viewer (you can search for Event Viewer from your Start menu).
  2. Expand Applications and Services Logs and select the K2 category.
  3. Check for K2 SharePoint Workflow Integration.
  4. The Information message's Source column shows when the SharePoint Webhook Endpoint is called.
  5. When SharePoint raises an event, the Webhooks endpoint will be processed.

Also check for errors in the:

See Known issue