Webhook as an Action

Step 1: Navigate to the Konnector Library

• Go to the Konnector Library Section: In your dashboard, look for the Konnectors tab in the navigation menu (this is usually on the left or at the top of your screen).
  
  

• Click the Konnectors: Clicking on this tab will open up the section where you can create, manage, and view all the Konnectors (integrations between different apps or services) that you’ve set up.

Step 2: Create a New Konnector or Edit an Existing On

• Create a New Konnector: If you're setting up a new Konnector, you should look for a “+ New” or “New Konnector” button ( on the top-right or within the Konnector Library section).
  
  

  • Select the Apps You Want to Integrate: A list of available applications or services that you can integrate with will appear. Select the apps or services that you want to connect.
    
    

  • Choose the Type of Integration: Depending on the available options, you may be prompted to choose from different types of integrations like “Triggers” (events that kick off an action) or “Actions” (tasks that get performed after a trigger).

• Edit an Existing Konnector: If you’re modifying an existing Konnector, simply locate it from the list of Konnectors in the Konnector Library.
  
  

  • Click on the Konnector name  to open the configuration settings and make changes.

Step 4: Define the Trigger for the Konnector

• A trigger is the event that will initiate the Konnector’s action. For example, you may want the Konnector to be triggered when a new user registers or when a form is submitted.
  
  

• Select the trigger event that will activate the Konnector. This could be a predefined event or a custom event you define based on your needs.
  
  

• For example, select "New User Registration" if you want the Konnector to trigger when a new user signs up.

Step 5: Add the "Webhook" Action

• Once you have defined the trigger, the next step is to set the actions that should be performed when the trigger is fired.
  
  

• In the action list, select "Webhook".Search for "Webhook".This means that when the trigger occurs, a webhook will be sent to an external service (like a third-party API or service).

Step 6: Configure the Webhook Action

Here’s how you’ll configure the webhook action:

1. Webhook URL:
   
   

   • Enter the Webhook URL where the data will be sent. This URL corresponds to the endpoint of the external service you want to notify.

   • Example: https://your-webhook-endpoint.com/api/receive-data
     
     

2. HTTP Method:
   
   

   • Select the HTTP method for the webhook. Most webhooks use POST to send data, but you can choose GET or other methods if needed.
     
     

3. Headers (Optional):
   
   

   • Add any required headers that your external service expects. Common headers include Authorization for API tokens and Content-Type for defining the format of the data (e.g., application/json).
     
     

Example:
 {

  "Authorization": "Bearer your-api-token",

  "Content-Type": "application/json"

}

4. Payload/Body:
   
   

   • Define the body or payload of the webhook request. This will be the data that is sent to the external service.
     
     

   • Use dynamic placeholders to pull in values from the trigger (such as user ID, email, etc.).

Example payload in JSON format:
 {

  "user_id": "{{user.id}}",

  "email": "{{user.email}}",

  "action": "new_registration"

}

• In this example, {{user.id}} and {{user.email}} are placeholders that will dynamically pull the actual user data when the webhook is triggered.

Step 7: Test the Konnector

• After configuring the webhook action, it’s important to test the Konnector to ensure it works as expected.
  
  

• Trigger the event manually or wait for the defined trigger to occur (e.g., have a new user register if your trigger is a new registration).
  
  

• Check if the external service is receiving the data from the webhook as intended. You may want to check the logs or status of the Konnector within Konnectify to see if any errors occurred.

Step 8: Save and Activate the Konnector

• Once you've confirmed that the webhook is functioning correctly during the test, save your Konnector configuration.

• You’ll also need to activate the Konnector to ensure that it runs automatically when the trigger event happens in the future.

Step 9: Monitor the Konnector

• After activation, you can monitor the Konnector via the Konnectify dashboard. You’ll be able to see logs and execution statuses to confirm that the webhook action is being triggered and executed correctly.
  
  

• If there are any issues or errors, you can adjust the configuration as necessary and retest.