Responses API

Sometimes you'll want to integrate Forms straight into your existing workflows rather than using our embed code. You can do this simply by using our REST API.

Authentication

Since this is an open endpoint used by our embed code, authentication is not necessary.

Endpoint

You can create a form response by sending a HTTP Post request to the following endpoint.

POST https://forms.clearbit.com/v1/responses

You'll need to send the following JSON encoded parameters.

Param name Description

form_id

Required Form ID (you can find this listed in the form's embed code)

values

Key/value hash of form parameters to values. Ensure these match the same Internal name used on the form's fields.

For example, to create a new response:

curl -H "Content-Type: application/json" -X POST \
-d '{"form_id":"123","values":{"name": "Alex MacCaw"}}' \
https://forms.clearbit.com/v1/responses