{"id":12492,"date":"2022-11-17T06:36:15","date_gmt":"2022-11-17T06:36:15","guid":{"rendered":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/?post_type=article&p=12492"},"modified":"2025-09-25T16:17:48","modified_gmt":"2025-09-25T10:47:48","slug":"webhooks","status":"publish","type":"article","link":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/webhooks\/","title":{"rendered":"Webhooks"},"content":{"rendered":"

\"Webhooks\"<\/p>\n

Webhooks can be used to notify changes in Nimble cards or user data to other tools and applications. When a specific event occurs in the Nimble, a webhook message is sent to a predefined third-party URL, delivering real-time information about that event, and data it changed, to the specified tool.<\/p>\n

Using webhooks, you can create any number of scenarios in which Nimble communicates directly with a specific tool whenever an event occurs in a project.<\/p>\n

Please note that only the enterprise creator and organization admin have access at the administration level, whereas only the project manager and team lead have access at the project level.<\/p>\n

Navigation<\/a><\/a><\/h2>\n

Project Level –<\/em> Navigate to the breadcrumb at the top hover over the Project name, expand the Setup<\/strong> module, and select Webhooks. OR<\/strong><\/p>\n

Administration Level –<\/em> In the left navigation panel, expand the Apps<\/strong> menu and select the Account Space<\/strong>. Hover over the top breadcrumb, expand the Administration<\/strong>\u00a0module, and select\u00a0Webhooks<\/strong>.<\/a><\/p>\n

Create Webhook<\/h2>\n

Go to your destination (specified) tool and prepare the URL that Nimble will use before creating a webhook. This URL will then be used to create a webhook.<\/p>\n

    \n
  1. Click the ADD<\/strong> button.<\/li>\n
  2. Enter a Name\u00a0<\/strong>identifying the webhook.<\/li>\n
  3. Enter or paste the payload URL<\/strong> to post the information that will be called when the webhook is triggered.<\/li>\n
  4. You can optionally specify a secret token if such a token-based validation mechanism is supported by the receiver.(Optional)<\/li>\n
  5. Enter the Description<\/strong> to further identify the intent of the webhook. (Optional)<\/li>\n
  6. Enable<\/strong> to make the webhook active, or Disable<\/strong> to make it inactive.<\/li>\n
  7. Check the Box\u00a0<\/strong>if only the action of the event needs to be sent, not the card details.<\/li>\n
  8. In the Card Type<\/strong> section, select the required card type that will trigger the selected event.<\/li>\n
  9. In the Event Triggers<\/strong> section, select the required events of the cards that will trigger sending your new webhook.<\/li>\n
  10. Click the SAVE<\/strong> button. The new webhook will be stored, and then create a Webhook dialog will close.<\/a><\/li>\n<\/ol>\n

    The new webhook will now be shown in the Webhooks<\/strong> List.<\/p>\n

    \"\"<\/a><\/p>\n

    View and Edit Webhook<\/h2>\n
      \n
    1. To view and edit a specific webhook, hover on the required webhook and then click the Edit<\/strong> button. The webhook details will appear.<\/li>\n
    2. Make the desired changes to the selected webhook.<\/a><\/li>\n
    3. Click the SAVE<\/strong> button to save the webhook Or the DELETE<\/strong> button to delete it.<\/li>\n<\/ol>\n

      Example of Webhook Response<\/h2>\n

      Every Webhook sent to your endpoint will have an event field in its body. This field will contain the payload with the event’s data (card details).<\/p>\n

      \r\n{\r\n"event": {\r\n"realmId": "NIMBLEQA",\r\n"accountId": "70051025",\r\n"ownerType": "Org",\r\n"ownerId": "70051526",\r\n"itemType": "PREQ",\r\n"itemId": "70051021",\r\n"userId": "70052143",\r\n"app": "nimble",\r\n"entity": "com.Robinson.cloud.nimble.EForm",\r\n"eventName": "addEForm",\r\n"entityVersion": "1",\r\n"apiVersion": "v1"\r\n},\r\n"content": {\r\n"CM_Priority": "--None--",\r\n"CREATEPROJECT": "Y",\r\n"Category": "--None--",\r\n"STARTDATE": "2022-11-29T00:00:00Z",\r\n"PROCESSTEMPLATE": "--None--",\r\n"CM_Description": "null",\r\n"PreqCategory": "--None--",\r\n"ISAGILE": "Y",\r\n"CM_CreationDate": "2022-11-29T12:04:50Z",\r\n"CM_CreatedBy": "70052143",\r\n"CM_OverallStatus": "Open",\r\n"CM_DUEDATE": "",\r\n"TASK_ACT_TRACKING_MODE": "Timesheet",\r\n"PROJECTMANAGER": "70052143",\r\n"TRACEDPROJECT": "",\r\n"EFORM_INSTANCE_ITEMID": "70051021",\r\n"TRACKINGBY": "PC",\r\n"PROJECTLEVEL": "--None--",\r\n"CM_CurrentStageName": "",\r\n"CM_Name": "olddemand",\r\n"WBSORDERBY": "--None--",\r\n"CM_ItemCode": "PREQ1",\r\n"PROJECTTYPE": "--None--",\r\n"ENDDATE": "2023-09-29T00:00:00Z",\r\n"FinancialTemplate": "--None--",\r\n"PROJECTCODE": "DEM000004",\r\n"TASKMODULE": "STaRT Plus",\r\n"CM_SeqNumber": "1"\r\n}\r\n}\r\n<\/pre>\n
      \n