Push to Custom EndpointPRO

The ‘Push to Custom Endpoint’ action allows you to push form saves and submissions to any URL endpoint using POST, GET, PUT, or DELETE methods.

This is useful if you need to push your data to a custom form handler.

Use the debug console log to see the response from your requests.

Note: We are unable to provide support for endpoints used with this action.

To create a ‘Push to Custom Endpoint’ action:

  1. When editing your form, click the ‘Actions’ icon at the top of the page. The ‘Actions’ sidebar will open on the right-hand side of the page.
  2. Click the ‘Add’  icon to add a new action.
  3. Select ‘Push to Custom Endpoint’ from the Action pulldown. A series of settings will appear.

As with all sidebars in WS Form, click the ‘Save’ button at the bottom to save your changes, or click ‘Cancel’ to disregard your changes.

The action settings are as follows:

When Should This Action Run?

You can choose to add the post when the form is saved, submitted, or both.

URL of Endpoint

Enter the URL of your endpoint, e.g. https://mysite.com/my_endpoint.php.

Request Method

Select the request method you would like to use when sending the data to your endpoint.

Content Type

Select the content you would like to use when sending the data to your endpoint.

Authentication

Select the authentication type you would like to use when sending the data to your endpoint. If you select a type, you will be prompted for a username and password.

Field Mapping

Field mapping tells WS Form which of your form fields to send to the endpoint and what the key name should be for the field’s value in your request data.

To map a field:

  1. Click the ‘Add’  icon at the bottom right of the field mapping section.
  2. In the left-hand column, select your form field.
  3. In the right-hand column, enter a key name.
  4. Repeat this process for each field on your form.
  5. Click the ‘Save’ button at the bottom of the sidebar to save your changes.
Custom Mapping

You can also add custom key/value mappings that are sent to your endpoint.

To add custom mapping:

  1. Click the ‘Add’  icon at the bottom right of the meta mapping section.
  2. Select your form field.
  3. In the left-hand column, enter a key name.
  4. In the right-hand column, enter a key value.
  5. Repeat this process for each field on your form.
  6. Click the ‘Save’ button at the bottom of the sidebar to save your changes.
Header Mapping

Header mapping allows you to add HTTP headers to your request.

OTo add a header mapping:

  1. Click the ‘Add’  icon at the bottom right of the meta mapping section.
  2. Select your form field.
  3. In the left-hand column, enter a header name.
  4. In the right-hand column, enter a header value.
  5. Repeat this process for each field on your form.
  6. Click the ‘Save’ button at the bottom of the sidebar to save your changes.