Embedding

Embed public forms

Embed Antly public object forms on external sites using /form/<code> and public object controllers.

Public object forms let anonymous visitors submit records into an Antly object. The hosted form route is:

text
/form/<code>

Use this route when you want the full Antly-hosted form experience with tenant branding, validation, success handling, and submission limits.

Iframe embed

html
1<iframe 2 src="https://<tenant-domain>/form/contact-us" 3 title="Contact us" 4 width="100%" 5 height="760" 6 style="border:0;border-radius:16px;overflow:hidden" 7></iframe>

The object must be published for public access. Public form controllers resolve the tenant and public object configuration before returning schema or accepting submissions.

Direct public controller calls

If you are building a custom frontend, call the public object controller instead of exposing an API key.

json
1{ 2 "__meta__": { 3 "schema": "controller", 4 "namespace": "objects.PublicObject", 5 "intent": "submit", 6 "authenticationClass": "public", 7 "return": { 8 "id": null, 9 "message": null 10 } 11 }, 12 "code": "contact-us", 13 "data": { 14 "name": "Ada Lovelace", 15 "email": "ada@example.com", 16 "message": "I would like a demo." 17 } 18}

Intent names can differ by public-form version, so prefer the hosted form unless you are implementing a supported custom surface.

For configurator setup, see /guides/public-object-forms and /guides/portal-public-exposure. For auth rules, see /developer/public-access.