Create a form

POST

/api/v1/projects/{id}/forms

curl --request POST \
  --url https://api.deploybase.eu/api/v1/api/v1/projects/example/forms \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "allowed_origins": [ "example" ], "honeypot_field": "example", "name": "example", "notify_emails": [ "example" ], "notify_team": true, "redirect_url": "example", "retention_days": 1, "store_ip": "example" }'

Creates a form endpoint for a project. The returned public_id is permanent and forms the public ingestion URL.

Authorizations

• BearerAuth

Parameters

Path Parameters

id

required

string

Project ID

Request Body

Form settings

Media type application/json

object

allowed_origins

Array<string>

honeypot_field

string

name

required

string

notify_emails

Array<string>

notify_team

NotifyTeam: whether team members get this form’s emails. Omitted means true.

boolean

redirect_url

string

retention_days

integer

store_ip

string

Example ^generated

{
  "allowed_origins": [
    "example"
  ],
  "honeypot_field": "example",
  "name": "example",
  "notify_emails": [
    "example"
  ],
  "notify_team": true,
  "redirect_url": "example",
  "retention_days": 1,
  "store_ip": "example"
}

Responses

201

Created

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

object

allowed_origins

Array<string>

created_at

string

deleted_at

string

enabled

boolean

endpoint_url

string

honeypot_field

string

id

string

name

Name is the dashboard identity, unique per project among live rows only — a soft-deleted form releases its name (uq_forms_project_name_active).

string

notify_emails

Array<string>

notify_team

NotifyTeam says whether the team gets this form’s submission emails at all (members from NotifyEmails, else the team notification address). false sends them nothing, so a form can go to its external recipients alone; NotifyEmails is kept, not cleared, so switching back on restores the pick. External recipients are not governed by it.

No default:true in the GORM tag, deliberately, though the COLUMN defaults to true (see TeamIDPConnection.JitEnabled): GORM substitutes the tag default for a zero value on INSERT, so a form created with notify_team=false would be written true. Every writer states the value; CreateFormInput.NotifyTeam is a *bool resolved to true when omitted.

boolean

project_id

ProjectID is immutable after creation. This is enforced structurally rather than by a check: UpdateFormInput has no project_id field, so no code path can reassign it.

string

public_id

PublicID is immutable after creation: it is baked into the customer’s deployed HTML, so regenerating it would silently break every live form pointing at it.

string

redirect_url

string

retention_days

integer

source

string

Allowed values: manual build_detected

store_ip

string

Allowed values: none truncated

team_id

string

updated_at

string

Example

{
  "data": {
    "source": "manual",
    "store_ip": "none"
  }
}

400

Bad Request

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

401

Unauthorized

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

403

Forbidden

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

404

Project not found

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

409

A form with this name already exists in this project

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}