Set Up Webhooks and Authentication in OnRamp

Updated

Want full two-way Zapier automation? This article covers OnRamp's native webhook system. For the native OnRamp Zapier app β€” with triggers, actions, searches, and 35+ operations β€” see Use the OnRamp Zapier Integration to Automate Your Workflows.

Webhooks let OnRamp automatically send data to an external system the moment something happens β€” a task is completed, a project is created, a subtask is answered. Use them to trigger workflows in tools like Zapier, Make, Jira, or any custom endpoint.


Before You Begin

  • You'll need Super Admin or Integrator access to reach Settings β€Ί Webhooks.

  • Have the destination URL ready β€” the endpoint you want OnRamp to send data to.

  • Know which trigger event you want to use (e.g., Task Completed, Project Created).


Step 1: Go to Webhooks in Settings

  1. In OnRamp, go to Settings β€Ί Webhooks (under Advanced in the left navigation).

  2. Click the Webhooks tab, then click Create Webhook.


Step 2: Enter Your Webhook Details

  • Webhook Name β€” Give it a descriptive name (e.g., Create Jira Ticket on Task Completion).

  • Trigger β€” Choose the OnRamp event that fires this webhook.

  • Webhook URL β€” Paste in your destination endpoint URL.

  • Authorization β€” Choose the authentication method:

    • No Authorization β€” Use this for Zapier and most no-code tools.

    • API Key / Token β€” Use this for secured or internal endpoints.


Step 3: Save and Activate

Click Create Webhook. The webhook is now active and will fire whenever the selected trigger occurs in OnRamp.


Available Triggers

You can view the full list β€” including data schemas β€” under Settings β€Ί Webhooks β€Ί Triggers.

  • Customer Invited to Project

  • Module Created / Deleted / Updated

  • Project Created / Archived / Completed

  • Project Details Updated

  • Project Note Created / Deleted / Updated

  • Task Created / Completed / Deleted / Updated

  • Subtask Created / Completed / Deleted / Updated

  • Task Help Requested


Example: Webhook + Zapier

  1. A customer completes a task in OnRamp.

  2. OnRamp fires the webhook to Zapier.

  3. Zapier creates a Jira ticket using the task's data.

For the full Zapier setup walkthrough, see Connect OnRamp Webhooks to External Apps with Zapier.


Tips & Troubleshooting

  • Testing your webhook: Use a service like Webhook.site to inspect payloads before connecting to a live system.

  • Authentication not working? Double-check your API key format β€” check whether the endpoint expects it in the header or as a query string parameter.

  • Webhook not firing? Confirm the trigger condition is actually occurring in OnRamp (e.g., the task must be explicitly marked complete).

  • Need two-way automation? The native OnRamp Zapier integration supports actions back into OnRamp. See Use the OnRamp Zapier Integration to Automate Your Workflows.

More in Webhooks, APIs & Custom Integrations