# Registration Form

## POST /public-api/v1/event/{eventId}/registration-form

> Create a registration form for an event

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"name":"Authorization","type":"apiKey","in":"header","description":"Bearer Authorization with jwt token"}}},"paths":{"/public-api/v1/event/{eventId}/registration-form":{"post":{"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"isEnabled":{"type":"boolean"},"fields":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["text","multipleText","textArea","singleCheckbox","radioGroup","checkboxGroup","dropdown","fileUpload","datePicker","phoneField","timePicker"]},"label":{"type":"string"},"isRequired":{"type":"boolean"},"contentI18n":{"type":"object","properties":{"label":{"type":"object","properties":{"default":{"type":["string","null"]},"en":{"type":["string","null"]},"ja":{"type":["string","null"]},"ko":{"type":["string","null"]},"vi":{"type":["string","null"]},"zh-HK":{"type":["string","null"]},"zh-CN":{"type":["string","null"]},"es":{"type":["string","null"]},"th":{"type":["string","null"]},"pt":{"type":["string","null"]}},"required":["default"],"additionalProperties":false}},"additionalProperties":false}},"required":["id","type","isRequired","contentI18n"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","enum":["name","firstName","lastName","email","secondaryEmails","jobTitle","organization","contactNo","city","country"]},"type":{"type":"string","enum":["text","multipleText","textArea","singleCheckbox","radioGroup","checkboxGroup","dropdown","fileUpload","datePicker","phoneField","timePicker"]},"isRequired":{"type":"boolean"}},"required":["id","type","isRequired"],"additionalProperties":false}]},"minItems":0},"conditionalLogics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"action":{"type":"object","properties":{"type":{"type":"string"},"targetQuestionId":{"type":"string","format":"uuid"}},"required":["type","targetQuestionId"],"additionalProperties":false},"condition":{"type":"object","properties":{"type":{"type":"string"},"questionOptionId":{"type":"string","format":"uuid"}},"required":["type","questionOptionId"],"additionalProperties":false},"sourceField":{"type":"string","format":"uuid"}},"required":["id","action","condition","sourceField"],"additionalProperties":false},"minItems":0},"tickets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ticketAvailableCount":{"type":"number","format":"float"},"currency":{"type":"string"},"qty":{"type":"number","format":"float"},"price":{"type":"string"},"saleStartsAt":{"type":"string","format":"date-time"},"saleEndsAt":{"type":["string","null"],"format":"date-time"},"minAddOnQty":{"type":"number","format":"float"},"maxAddOnQty":{"type":["number","null"],"format":"float"},"name":{"type":"string"},"description":{"type":"string"},"message":{"type":"string"},"addOns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string"},"price":{"type":"string"},"type":{"type":"string"},"stockQty":{"type":"number","format":"float"},"addOnAvailableCount":{"type":"number","format":"float"},"startDateTime":{"type":["string","null"],"format":"date-time"},"endDateTime":{"type":["string","null"],"format":"date-time"}},"required":["id","name","price","type","stockQty","addOnAvailableCount","startDateTime","endDateTime"],"additionalProperties":false},"minItems":0},"addOnGroups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"minQty":{"type":"integer","minimum":0},"maxQty":{"type":["integer","null"],"minimum":0},"addOnIds":{"type":"array","items":{"type":"string","format":"uuid"}}},"required":["id","name","minQty","maxQty","addOnIds"],"additionalProperties":false}}},"required":["id","ticketAvailableCount","currency","qty","price","saleStartsAt","saleEndsAt","minAddOnQty","maxAddOnQty","name","addOns","addOnGroups"],"additionalProperties":false},"minItems":0},"isAddOnGroupDisplayEnabled":{"type":"boolean"}},"required":["id","name","isEnabled","fields","conditionalLogics","tickets","isAddOnGroupDisplayEnabled"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"500":{"description":"ERROR"}},"parameters":[{"schema":{"type":"string","format":"uuid"},"name":"eventId","in":"path"}],"tags":["Registration Form"],"operationId":"createRegForm","summary":"Create a registration form for an event","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"isEnabled":{"type":"boolean"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","enum":["name","firstName","lastName","email","secondaryEmails","jobTitle","organization","contactNo","city","country"]},{"type":"string","format":"uuid"}]},"isRequired":{"type":"boolean"},"contentI18n":{"type":"object","properties":{"label":{"type":"object","properties":{"default":{"type":["string","null"]},"en":{"type":["string","null"]},"ja":{"type":["string","null"]},"ko":{"type":["string","null"]},"vi":{"type":["string","null"]},"zh-HK":{"type":["string","null"]},"zh-CN":{"type":["string","null"]},"es":{"type":["string","null"]},"th":{"type":["string","null"]},"pt":{"type":["string","null"]}},"required":["default"],"additionalProperties":false}},"additionalProperties":false}},"required":["id","isRequired"],"additionalProperties":false}},"conditionalLogics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"sourceField":{"type":"string","format":"uuid"},"condition":{"type":"object","properties":{"type":{"type":"string","enum":["optionEqualsTo","equalsTo"]},"questionOptionId":{"type":"string","format":"uuid"}},"required":["type","questionOptionId"],"additionalProperties":false},"action":{"type":"object","properties":{"type":{"type":"string","enum":["show","hide"]},"targetQuestionId":{"type":"string"}},"required":["type","targetQuestionId"],"additionalProperties":false}},"required":["id","sourceField"],"additionalProperties":false},"uniqueItems":true},"ticketClassIds":{"type":"array","items":{"type":"string","format":"uuid"}},"isUniqueAttendeeEmailRequired":{"type":"boolean","default":false},"isCheckInQRCodeVisibleOnCompletion":{"type":"boolean","default":false},"isPromoCodeFieldEnabled":{"type":"boolean","default":true},"isPurchaserEmailFieldEnabled":{"type":"boolean","default":true},"isAddOnGroupDisplayEnabled":{"type":"boolean","default":false},"minTicketQtyPerOrder":{"type":"number","format":"float","default":1},"maxTicketQtyPerOrder":{"type":"number","format":"float","default":10}},"required":["name","isEnabled","fields","conditionalLogics","ticketClassIds"],"additionalProperties":false}}}}}}}}
```


---

# 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://eventx-hq.gitbook.io/knowledge-base/api-doc/registration-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.