View-Based POST for Inserting a Connected Record

In this example, the page we will be working with has a detail view of a Company, but also contains a form view to insert a connected Employee record. The form data source is configured as "This form inserts a Employee record connected to this page's Business record."

Identify the scene URL and parent Company record id for which children records you want to retrieve. Viewing the page in the Live App will give you this data in the URL. Example: https://my-account.knack.com/my-app#companies/company-details/5d65bad5614e4d001047b585/
Following the View-Based POST examples we can construct a URL to insert this new Employee record connected to this page's Company record. The POST URL will be a regular view-based request to this view:

URL
POST https://api.knack.com/v1/scenes/scene_xx/views/view_yy/records

Parameters

Parameter	Explanation	Example
scene_xx	scene key	scene_3
view_yy	view key	view_5

Headers

Key	Value
X-Knack-Application-Id	Your application ID
Authorization	A user token valid for the view (if view is nested under a login)
content-type	application/json

Example Request

curl -X POST "https://api.knack.com/v1/pages/scene_3/views/view_5/records" \
  -H "X-Knack-Application-Id: YOUR-APP-ID" \
  -H "X-Knack-REST-API-Key: knack" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "field_1": "5d65bad5614e4d001047b585"
}'

📘
Note: this connection field value between the Employee and Company object is automatically set when using this form in the Live App but needs to be manually included when using the form for an API call.