# Form

Create form submissions on behalf of a guest

## Create a Form Submission

<mark style="color:green;">`POST`</mark> `v1/guests/:guest_id/form`

#### Request Body

| Name                                        | Type   | Description                                                                               |
| ------------------------------------------- | ------ | ----------------------------------------------------------------------------------------- |
| venue\_id<mark style="color:red;">\*</mark> | String | The venue ID that the form is applicable for. Must be exactly 12 alphanumeric characters. |
| source                                      | String | Source of the form submission. Must be either "web" or "in-venue-form". Defaults to "web" |
| form\_id                                    | String | A 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)

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.stampede.ai/guests/form.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.