Using Webhook
Get data delivered straight into your application whenever a user imports a file using Impler.
Last updated
Was this helpful?
Get data delivered straight into your application whenever a user imports a file using Impler.
Last updated
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.
To configure a webhook destination in Impler:
Open the Import panel and navigate to the Destination section.
Enable the Webhook option.
Provide the REST API Endpoint of your application.
(Optional) Provide values for authentication and retry configuration.
🔒 Use
authHeaderName
andauthHeaderValue
if your endpoint requires authentication.
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.
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.
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.
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
).
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.
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.
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.