LogoLogo
WebsiteCommunity
  • Overview
    • Introduction
    • How to use it? In 5 steps
  • Importer
    • React Embed
    • Angular Embed
    • Bubble.io Embed
    • HTML & JS Embed
    • Text Customization
    • Directly Enter your Data
    • Select Header Row
  • Data Retrieval
    • Using Webhook
    • Using Frontend Callback
  • Validations
    • Base Validations
    • Advanced Validations
  • Features
    • Data Seeding
    • Import Excel with Image
    • Automated Import
    • Runtime Schema
    • Custom Validation
    • Default Value
    • Column Description
    • Freeze Columns
    • Multiselect Dropdown
    • Output Customization
  • Platform
    • Email Alerts
    • Activity Page
    • Manage Project
    • Make Your Team
    • How subscription works?
  • Additional Resources
    • FAQs
    • Architecture
    • Data Migrations
    • Selfhost Impler
    • Run Impler locally
    • Writing effectively into .xlsm files
  • Changelog
Powered by GitBook
On this page
  • How to add a Webhook Destination?
  • Chunk Size
  • Authentication
  • Rate Limiting & Retry Mechanism
  • Webhook Data Format

Was this helpful?

Edit on GitHub
Export as PDF
  1. Data Retrieval

Using Webhook

Get data delivered straight into your application whenever a user imports a file using Impler.

PreviousSelect Header RowNextUsing Frontend Callback

Last updated 14 days ago

Was this helpful?

Once the user completes importing the spreadsheet via the widget, Impler sends the imported data to the callback URL specified in the destination section.

If your callback URL is protected, you can enable header-based authentication. This ensures secure data transfer to your API endpoints.

How to add a Webhook Destination?

To configure a webhook destination in Impler:

  1. Open the Import panel and navigate to the Destination section.

  2. Enable the Webhook option.

  3. Provide the REST API Endpoint of your application.

  4. (Optional) Provide values for authentication and retry configuration.

🔒 Use authHeaderName and authHeaderValue if your endpoint requires authentication.

Chunk Size

You can configure the number of records sent per request by specifying a Chunk Size. This determines how many records Impler will include in a single webhook payload.

Authentication

To secure your API, Impler supports header-based authentication.

  • Use the authHeaderName field to define the name of the header.

  • Use the authHeaderValue prop in the import button to define its value.

These values are not visible to end users and are only transmitted when the webhook is triggered.

Rate Limiting & Retry Mechanism

To ensure reliable data delivery and avoid data loss during transient errors or server-side rate limits, Impler supports a configurable retry mechanism. This is particularly useful when your webhook endpoints are subject to rate-limiting or temporary unavailability.

How Retry Works

When a webhook request to your endpoint fails (due to timeouts, rate-limiting responses like 429 Too Many Requests, or other non-2xx errors), Impler will retry the request based on the following two parameters:

  • Retry Count: Defines how many times Impler will attempt to resend the data after the initial failure.

  • Retry Interval: The interval (in milliseconds) between each retry attempt.

📝 Note: If not configured, Impler will not retry by default (RetryCount = 0).

Developer Notes

  • The retries apply per chunk of data sent.

  • Retries apply only for failed HTTP responses (non-2xx).

  • If the final retry still fails, the chunk is considered undelivered, and a failure log is recorded.

  • Ensure your API implements idempotency to handle retries safely without duplicate processing.

  • If your server enforces rate limits (like 10 requests/second), set RetryInterval accordingly (e.g., 1000ms or more).

  • Combine with Authentication Headers for secure, controlled access.

Webhook Data Format

Name
Description

template

CODE of the template used for import

uploadId

Unique identifier for the upload

data

Array of data in JSON format

totalRecords

Total number of records in uploaded spreadsheet

totalPages

Total number of pages the data is split into

page

Current page number being sent

pageSize

Number of records in this chunk

extra

Extra string or JSON if it's being passed to Import button

For integration help, refer to: for React and for HTML & JS Embed.

Providing Authentication Header Value
Steps to Add Webhook Destination

If you have any questions, suggestions, or comments. Feel free to reach out to us over . We’re constantly improving to deliver the best Data Importer for your product, and we value your input.

Discord
Providing Authentication Header Value