Webhooks events

From Nintex K2 Cloud Update 21 onwards there are two different apps for SharePoint Online. The legacy Nintex K2 Cloud for SharePoint app: used for SharePoint upgraded tenants, and the Nintex K2 Cloud (SPFx) app: used for new tenants.

For the product 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 the product 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 action is currently not supported:

SharePoint > Document Library:

  • Discard Document Check Out

SharePoint Online workflow events

If you have issues with Nintex K2 Cloud (SPFx) app workflow events, make sure the Webhook URL for the list is subscribed by SharePoint and is publicly accessible:

  1. Navigate to Management.
  2. Execute the Get Webhook Subscriptions SmartObject method.

    • Categories > 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 method.
  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 contact Nintex Customer Central