Create Webhook

Create Webhook

Overview
This API creates an outgoing webhook in your Zoho Connect network. When this API is invoked, a validation post call (ping trigger) is sent to the URL end-point. That URL end-point must respond with a 200 OK message to confirm the creation of webhook. In case the end-point does not send a 200 OK message as a response the webhook will not be created.

API

POST /api/v1/webhook


Oauth Scope

ZohoPulse.outgoingwebhook.CREATE

 

Sample request

  1. $curl -X POST https://connect.zoho.com/api/v1/webhook
  2. -H "scopeid:5313000000002002"
  3. -H" Authorization:Zoho-oauthtoken        1000.3d0a155402XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  4. -d '{
  5. "name":"Notify in Cliq",
  6. "active":"false",
  7. "autoRetry":"true",
  8. "description":"Notify important Connect activities in a Zoho Cliq Channel",
  9. "triggers":[
  10. {
  11. "type":"Board_Created"
  12. },
  13. {
  14. "type":"Task_Assigned"
  15. },
  16. {
  17. "type":"User_Mentioned_In_Post",
  18. "partitionIds":["3000000005135"]
  19. },
  20. {
  21. "type":"Group_Mentioned_In_Post",
  22. "partitionIds":["3000000005135"]
  23. }
  24. ],
  25. "url":"https://cliq.zoho.com/api/v2/channelsbyname/zo
  26. hoconnect/message"
  27. }'

 

Sample response

  1. {
  2. "id": "3000000126027",
  3. "name": "Notify in Cliq",
  4. "active": "false",
  5. "autoRetry": "true",
  6. "createdTime": "1635755951141",
  7. "createdBy": "15521849",
  8. "description": "Notify important Connect activities in Zoho Cliq Channel",
  9. "url":"https://cliq.zoho.com/api/v2/channelsbyname/zo
  10. hoconnect/message",
  11.   "triggers":[
  12. {
  13. "type": "Board_Created"
  14. },
  15. {
  16. "type": "Task_Assigned"
  17.   },
  18. {
  19. "type": "User_Mentioned_In_Post",
  20. "partitionIds":["3000000005135"]
  21. },
  22.      {
  23.        "type": "Group_Mentioned_In_Post",
  24.     "partitionIds": ["3000000005135"]
  25.      }
  26.    ]
  27. }

 

For any queries related to outgoing webhooks, reach out to us at support@zohoconnect.com. We're happy to help!