Forms

Create form submission

Submits an answer set to a specific Form. Customer is upserted by email; lead-magnet purpose forms also trigger delivery.

post/forms/{form_id}/submissions

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/forms/{form_id}/submissions
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

emailstring required
namestring nullable
answersobject required

Map of form_field id → answer value. A consent field takes true when the person agreed.

ip_addressstring nullable

The submitter's IP address, kept with the submission as a record of consent.

Response

Submission created

idstring required
objectstring required
respondent_typestring required
confirmation_requested_atstring date-time nullable required
confirmed_atstring date-time nullable required
delivered_atstring date-time nullable required
created_atstring date-time required
respondent_idstring required
form_idstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.