Form Webhooks

Use Basin to repost submission data to other apps and services.

Configuring a webhook


If you only need to forward submission data to a single app or service, then a custom webhook is a great solution. To setup a custom webhook in Basin, go to theIntegrationspage in your form dashboard, enter your desired URL in the input field, save, and you're all set!

When a submission is received by an endpoint with a configured webhook URL, Basin will queue up a post on your behalf. If the webhook fails, we will retry up to 15 times over the course of 24-28 hours with an exponential backoff. The format of our webhooks will be exactly what we receive on the inital form submission.

Only submissions that are not flagged as spam will trigger a webhook by default. There is a checkbox to enable webhooks for all submsissions. This is an excellent strategy for bypassing any spam filtering by Basin.

Form Webhook API

Create, Update, Delete, List, and Show your Webhooks.

Webhook API Actions


ActionMethodPath
ListGET/api/v1/form_webhooks
ShowGET/api/v1/form_webhooks/:id
CreatePOST/api/v1/form_webhooks
UpdatePUT/api/v1/form_webhooks/:id
DeleteDELETE/api/v1/form_webhooks/:id

List webhooks


You can return a list of your webhooks.

ArgumentOptions
query (string, optional)Filter your webhooks by name, id, url, or associated form_id
page (integer, optional)Change the page
Example API call
HTTPS
https://usebasin.com/api/v1/form_webhooks?filter_by=All&page=1&query=&api_token={account_api_token}

Make sure you swap out  {account_api_token}  with your account wide API token found on your Account Setting page.

Show/Delete a webhook


You can return the attributes of a single webhook or delete a webhook using its id.

ArgumentOptions
id (integer)The the webhook with this id
Example API call
HTTPS
https://usebasin.com/api/v1/form_webhooks/{form_webhook_id}?api_token={account_api_token}

Make sure you swap out  {account_api_token}  with your account wide API token found on your Account Setting page.

Create/Update a webhook


The following attributes are available to you.

AttributeType
namestring
urlstringThe url for the webhook
formatstringFormat for the payload to be sent in.Valid options are:form_url_encoded, json, slack, zapier_2_0_1, data_json, discord
trigger_when_spambooleanWhether to trigger the webhook for submissions marked as spam.
enabledbooleanEnable/Disable the webhook.
Example API call
HTTPS
https://usebasin.com/api/v1/form_webhooks?api_token={account_api_token}{"webhook":{"name":"webhookname",...}}

Make sure you swap out  {account_api_token}  with your account wide API token found on your Account Setting page.