Kickstarting your webhook integration

Before you dive into setting up the webhook, ensure you:

• Create the custom object: Create your custom object and add it to the menu. See Creating custom objects. For the Jira webhook used in the upcoming tutorial, we’ll be using the Offboarding Employee object.
• Create the custom object fields: These are crucial as they will store the incoming data. Depending on your needs, you can have one or multiple fields. See Creating custom object fields. For the Jira webhook used in the upcoming tutorial, we will create the following fields:
  • Jira Ticket ID
  • Employee Name
  • Employee Email
  • Department
  • Offboarding Status
  • Assigned To 
• Retrieve your Oomnitza API endpoint: This unique link directs where the webhook's data should be sent. The link is typically structured as:
  • Domain: Typically, it’s of the form https://<mycompany>.oomnitza.com.
  • API version: Refer to Configuration > Integrations > Rest APIs (Swagger docs) on your platform for details.
  • Custom Object name: The name of the object that you want to update. Custom objects use the prefix “co_” in their names. In this guide, we’ll explore the “co_offboarding_employee” object: https://mycompany.oomnitza.com/api/v3/co_offboarding_employee
• Secure your Oomnitza API token: To generate the token, click Configuration > Security > API tokens.