Getting Started With Incoming Webhooks

Getting Started with Incoming Webhooks

Incoming webhooks enable you to receive and act on data sent from third-party platforms directly into your Tadabase app. This powerful feature allows you to automate data synchronization and eliminate manual data entry.

What are Incoming Webhooks?

Incoming webhooks are automated data receivers that listen for information from external services. When an event happens in another platform (like a new customer in Stripe or a form submission in JotForm), that platform can automatically send data to your Tadabase app.

Common Use Cases

• Sync customer updates from payment platforms like Stripe
• Receive form submissions from external form builders
• Import data from scheduling systems like Calendly or Acuity
• Capture leads from marketing platforms
• Process orders from e-commerce systems

The Tadabase Webhook Catcher is purpose-built for your apps and can handle larger volumes and faster processing compared to third-party automation tools like Zapier.

Getting Started

Setting up your first incoming webhook takes just three steps:

1. Create your webhook catcher account
2. Add your Tadabase app connection
3. Create and configure your webhook

Step 1: Create Your Account

Visit https://catch.tadabase.io to create your webhook catcher account.

Important: Use the same email address as your Tadabase account when signing up. You can choose any password you prefer.

The Webhook Catcher is built as a separate microservice to ensure faster updates, better scalability, and improved performance for handling your incoming webhooks.

Step 2: Add Your Tadabase App

Once logged in, you'll need to connect your Tadabase app by providing:

• App Name: A friendly name to identify this app
• Description: Optional notes about this app connection
• API Credentials: Your app's API ID, Key, and Secret from Tadabase

To find your API credentials in Tadabase:

1. Open your Tadabase app
2. Go to Settings → API & Services
3. Copy your Application ID, Application Key, and Application Secret

Step 3: Create Your First Webhook

Click "Create Webhook" to set up your first incoming webhook receiver:

Basic Information

• Webhook Name: A descriptive name for your reference (e.g., "Stripe Customer Updates")
• Description: Optional notes about what this webhook does
• Connected App: Select the app you added in Step 2

Equation Handling

Choose how Tadabase should process equations when data is received:

• Run Equations: Process all equations immediately (slower but ensures data is complete)
• Send to Queue: Add equations to a background queue (faster initial response)
• Don't Run Equations: Skip equation processing entirely (fastest option)

If you choose "Don't Run Equations," you'll need to manually trigger equation updates using a separate API call.

Get Your Webhook URL

After creating the webhook, you'll receive a unique webhook URL that looks like:

https://catch.tadabase.io/webhook/abc123xyz

Copy this URL and paste it into your external service's webhook settings.

Example: Setting Up a Stripe Webhook

Let's walk through connecting Stripe customer updates to your Tadabase app:

1. In Stripe, navigate to Developers → Webhooks
2. Click Add endpoint
3. Paste your webhook URL from Tadabase
4. Select the events you want to track (e.g., "Customer Created")
5. Save the endpoint

Now, create a test customer in Stripe. Within seconds, you'll see the request appear in your webhook catcher!

Next Steps

Once you've received your first webhook request, you'll need to configure field mapping to tell Tadabase where to save the incoming data. The next step is to:

• Choose which data table to use
• Decide whether to create new records or update existing ones
• Map fields from the incoming data to your Tadabase fields

For detailed instructions on field mapping and advanced features, continue to the field mapping guide.

Important Notes

• Each webhook can be connected to one app and one data table
• You can create unlimited webhooks (subject to your plan limits)
• Webhook URLs are permanent and won't change unless you regenerate them
• Failed webhook calls are logged and can be retried manually
• You can test webhooks without connecting to an external service using the sample request feature

Troubleshooting

Webhook Not Receiving Data

• Verify the webhook URL is correctly entered in your external service
• Check that the external service is actually sending data (test using their tools)
• Review your webhook's security settings to ensure requests aren't being blocked

Connection Test Fails

• Double-check your API credentials are correct
• Ensure your Tadabase app is active and not suspended
• Verify you're using the correct Application ID, Key, and Secret