Stampede

Form

Create form submissions on behalf of a guest

Create a Form Submission

POST/v1/guests/:guest_id/form

Request Body

NameTypeDescription
venue_idrequiredStringThe venue ID that the form is applicable for. Must be exactly 12 alphanumeric characters.
sourceStringSource of the form submission. Must be either "web" or "in-venue-form". Defaults to "web"
form_idStringA unique ID of your choice to identify the form the user has filled in. Optional.

Validation Rules

  • venue_id: Required. Must be exactly 12 alphanumeric characters (a-z, A-Z, 0-9)
  • form_id: Optional. Can be any string value
  • source: Must be either "web" or "in-venue-form". Defaults to "web" if not provided

Notes

  • The organisation_id is automatically added from your authentication context
  • The guest_id is taken from the URL parameter
  • If form_id is not provided, it defaults to null

Response

Returns the created form data object.

Error Response (422: Unprocessable Entity)

{
  message: string;
  errors: {
    code: string;
    expected?: string;
    received?: string;
    path: string[];
  }[];
}