{"uid":"cap_sz1qqbI6ZQhjQtEyS0FdH","slug":"forms-withzero-xyz-zero-forms-create-hosted-web-form-5ca42e76","name":"Zero Forms – Create Hosted Web Form","description":"Create a hosted web form from a field schema and get a public URL where it can be filled in.","url":"https://forms.withzero.xyz/api/v1/forms","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["schema","recipients"],"properties":{"title":{"type":"string","maxLength":200,"description":"Optional heading shown above the form."},"schema":{"type":"object","description":"JSON Schema describing the form fields (rjsf-compatible).","propertyNames":{"type":"string"},"additionalProperties":{}},"webhook":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Each submission is POSTed here (HMAC-signed), alongside the email notification."},"secret":{"type":"string","maxLength":256,"minLength":8,"description":"HMAC secret. Required when the receiver verifies signatures — e.g. an inbox generic connection."}},"description":"Optional delivery webhook. Point it at an inbox connection URL to flow submissions into an agent inbox.","additionalProperties":false},"uiSchema":{"type":"object","description":"Optional rjsf UiSchema for widget hints and ordering.","propertyNames":{"type":"string"},"additionalProperties":{}},"recipients":{"type":"array","items":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"maxItems":20,"minItems":1,"description":"1–20 email addresses notified on each submission."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id","url","submitUrl"],"properties":{"id":{"type":"string","description":"6-character form id."},"url":{"type":"string","format":"uri","description":"Public URL where the form renders."},"submitUrl":{"type":"string","format":"uri","description":"Endpoint the rendered form POSTs submissions to."}},"additionalProperties":false},"example":{"request":{"title":"Customer Feedback Survey","schema":{"type":"object","required":["name","email","rating"],"properties":{"name":{"type":"string","title":"Full Name"},"email":{"type":"string","title":"Email Address","format":"email"},"rating":{"type":"integer","title":"Overall Satisfaction","maximum":5,"minimum":1},"comments":{"type":"string","title":"Additional Comments"}}},"recipients":["zero-qa@agentmail.to"]},"response":{"id":"9fe2k9","url":"https://forms.withzero.xyz/#9fe2k9","submitUrl":"https://forms.withzero.xyz/api/v1/forms/9fe2k9/submissions"}},"exampleRequest":{"title":"Customer Feedback Survey","schema":{"type":"object","required":["name","email","rating"],"properties":{"name":{"type":"string","title":"Full Name"},"email":{"type":"string","title":"Email Address","format":"email"},"rating":{"type":"integer","title":"Overall Satisfaction","maximum":5,"minimum":1},"comments":{"type":"string","title":"Additional Comments"}}},"recipients":["zero-qa@agentmail.to"]},"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"free_handshake","priceSource":"registry","requiresHandshake":true,"reviewCount":8,"rating":{"score":"0.97","successRate":"0.92","reviews":8,"stars":"4.9","state":"rated"},"availabilityStatus":"healthy","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"free · handshake required","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_fj9aem9did4YsmrHJwJEG","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"forms.create:1"}],"brandName":"forms.withzero.xyz","brandSlug":"forms-withzero-xyz-mpp","brandBaseUrl":"https://forms.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Creates a hosted web form from a JSON Schema definition and returns a public URL where respondents can fill it in, with submissions emailed to specified recipients.","exampleAgentPrompt":"Create a hosted web form called 'Customer Feedback Survey' with fields for full name (text), email address, overall satisfaction rating (1–5), and additional comments (text), and send submission notifications to feedback@mycompany.com.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a 6-character form ID, a public URL (e.g. https://forms.withzero.xyz/#abc123) where the form can be filled in by anyone, and a submit endpoint URL that the rendered form posts responses to.","failureModes":["Invalid JSON Schema in 'schema' field — returns 400 with validation error","No recipients provided or recipients array is empty — returns 400 (minItems: 1 violation)","More than 20 recipients specified — returns 400 (maxItems: 20 violation)","Malformed email address in recipients — returns 400 with pattern validation error","Title exceeds 200 characters — returns 400","Missing required 'schema' or 'recipients' fields — returns 400"],"whenToPreferThis":"Use this endpoint when an AI agent needs to collect structured data from humans via a browser-accessible form without building any frontend UI. Ideal when the form fields are already expressible as a JSON Schema (rjsf-compatible) and you want respondents to receive a simple public URL. Prefer this over general form builders when operating in an agentic workflow that can programmatically define field schemas and route submission notifications to email addresses.","instructions":null,"reviewSummary":"Reliably creates hosted web forms from rjsf JSON Schema and uiSchema in under 10 seconds, returning a public URL, form ID, and submit endpoint at no cost. CORS-enabled submissions endpoint accepts cross-origin JSON POSTs and triggers email delivery to specified recipients. Rendering is functional but limited — ui:submitButtonOptions, schema.description, and ui:help are ignored; only title, field titles, placeholders, and required markers display.","reviewSummaryHighlights":["Fast form creation (typically 1–8s) with free API calls","Full rjsf JSON Schema + uiSchema support including textarea widget and ui:order","CORS-enabled submit endpoint allows cross-origin JSON POST from static sites"],"reviewSummaryConcerns":["No read endpoint for submissions — notification email is the only record of responses","Hosted renderer ignores ui:submitButtonOptions, schema.description, and ui:help fields","Requires a non-zero payment cap parameter; --max-pay 0 blocks the handshake and fails"],"reviewSummaryGeneratedAt":"2026-09-06T02:15:07.136Z","activationCount":44,"lastUsedAt":"2026-09-06T01:20:16.840Z","lastSuccessfullyRanAt":"2026-09-06T01:20:16.840Z","lastHealthCheckAt":"2026-09-16T13:07:44.737Z","isFirstParty":true}