Skip to main content
POST
Create a new form

Authorizations

Authorization
string
header
required

Authentication using either a FormBnB session JWT (issued by /auth) or an API key (prefixed with sk_). Both token types are passed as Bearer tokens in the Authorization header.

Body

application/json
name
string
required

Form name

Required string length: 1 - 100
org_id
string<uuid>
required

Organization ID

description
string

Form description

Maximum string length: 500

Response

Created form

id
string<uuid>
required
name
string
required
slug
string
required
description
string | null
required
is_active
boolean
required
user_id
string<uuid>
required
org_id
string<uuid>
required
email_notifications
boolean
required
notification_email
string | null
required
notification_emails
string[] | null
required
redirect_url
string | null
required
allowed_domains
string[] | null
required
webhook_enabled
boolean
required
webhook_url
string | null
required
webhook_secret
string | null
required
custom_email_subject
string | null
required
custom_email_template
string | null
required
auto_responder_enabled
boolean
required
auto_responder_subject
string | null
required
auto_responder_body
string | null
required
auto_responder_from_name
string | null
required
auto_responder_include_data
boolean
required
slack_enabled
boolean
required
slack_webhook_url
string | null
required
discord_enabled
boolean
required
discord_webhook_url
string | null
required
google_sheets_enabled
boolean
required
google_sheets_url
string | null
required
telegram_enabled
boolean
required
telegram_bot_token
string | null
required
telegram_chat_id
string | null
required
created_at
string
required
updated_at
string
required