Create submission — ioZen Docs

POST

/intake-bots/{id}/submissions

POST

/intake-bots/{id}/submissions

Authorization

bearerAuth

headerAuthorizationBearer <token>

API key authentication. Pass your ioZen API key as a Bearer token in the Authorization header.

Request Body

Submission field values and options

application/json

body

data*

Field values keyed by field name from the intake bot schema. Values may be string, number, boolean, string[], or null. Select an example from the dropdown in the code panel to pre-fill realistic values.

status?string

Submission status — COMPLETED triggers webhook events

Default"COMPLETED"

Value in"IN_PROGRESS""COMPLETED"

is_test?boolean

Mark as test submission (excluded from analytics)

Defaultfalse

Response Body

Submission created successfully

application/json

response

submission*

curl -X POST 'https://app.iozen.ai/api/v1/intake-bots/cm7abc12x0001yz9k8mno3pqr/submissions' \
  -H 'Content-Type: application/json' \
  -d '{
  "data": {
    "full_name": "Jane Doe",
    "email": "jane@example.com",
    "company": "Acme Corp"
  },
  "status": "COMPLETED",
  "is_test": false
}'

curl -X POST 'https://app.iozen.ai/api/v1/intake-bots/cm7abc12x0001yz9k8mno3pqr/submissions' \  -H 'Content-Type: application/json' \  -d '{  "data": {    "full_name": "Jane Doe",    "email": "jane@example.com",    "company": "Acme Corp"  },  "status": "COMPLETED",  "is_test": false}'

Example ResponseSchema

{
  "success": true,
  "data": {
    "submission": {
      "id": "cm7sub01a0001yz9k8mno3pqr",
      "status": "COMPLETED",
      "created_at": "2026-02-22T11:00:00.000Z"
    }
  }
}

{  "success": true,  "data": {    "submission": {      "id": "cm7sub01a0001yz9k8mno3pqr",      "status": "COMPLETED",      "created_at": "2026-02-22T11:00:00.000Z"    }  }}

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Request Body

Response Body