Skip to main content
POST
/
v1
/
forms
/
{id}
/
responses
Submit a form response
curl --request POST \
  --url https://clientapi.woku.app/v1/forms/{id}/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "anonymous": true,
  "answers": {},
  "email": "jsmith@example.com",
  "phone": "<string>"
}
'
{
  "statusCode": 400,
  "message": "<string>",
  "error": "Bad Request"
}

Authorizations

​
Authorization
string
header
required

Company API key. Obtain this from your Woku dashboard under Settings > API Keys. The same key used for the v0 endpoints.

Path Parameters

​
id
string
required

Form id

Body

application/json
​
anonymous
boolean
required

Whether this response is anonymous.

​
answers
object
required

Answers keyed by field id, e.g. { "field-uuid-1": "John", "field-uuid-2": 5 }.

​
email
string<email>

Respondent email (required when the form identifies clients by email and the response is not anonymous).

​
phone
string

Respondent phone (required when the form identifies clients by phone and the response is not anonymous).

Response

Form response created