Quickbase Automation Developer Lab · Lesson 20

Creating Related Records and Capturing New Identity

Lesson 19 used an existing identity to find a record. Lesson 20 creates a related Task, deliberately maps several field types, and captures an identity that did not exist until Quickbase completed the Create Record action.

What this lesson adds

From locating records to producing records

The pipeline begins with an existing Project and constructs a new Task field by field. The Project keeps its identity. Quickbase assigns a separate Record ID to the Task after creation.

Lesson 19

Which existing record?

Lesson 20

What new record?

Central mental model

One event, one decision, two possible paths

Project updated
Project Status = Active?
Yes
Create related Task
Return new Task Record ID
No
End without creating
PREDICTED

Predict before building

What should happen when a Project becomes Active?
What should happen when it becomes On Hold?
Which values should come from the Project?
Which values should be fixed literals?
How will the Task become related to the correct Project?
What identity should Create Record return?
If two Projects become Active in one save, will one or two Tasks be created?

Predict → Build → Run → Inspect → Explain

Trigger configuration

Begin with an updated Project

Record Updated

App
Automation
Table
Projects
Any field
Off
Trigger field
Project Status
Records changed
Any

Fields for subsequent steps

  • Project Name
  • Project Status
  • Project Manager
  • Target Date
  • Record ID, supplied as a system field
Trigger outputLater purpose
Project NameBuild the Task Name
Project StatusEvaluate the condition
Project ManagerAssign the Task
Target DateSet the Task Due Date
Record IDEstablish the relationship

Guard with business logic

Project Status is equal to Active

The trigger proves that status changed. The condition decides whether the current value qualifies for creation. On Hold → Active, Active → On Hold, and Active → Complete are all status changes, but only the first qualifies.

Add Create Record

If condition is met:

Quickbase → Records → Create Record

App
Automation
Table
Tasks
Fields
Task Name, Due Date, Status, Assigned To, Related Project

The false branch remains empty and finishes normally.

Complete field map

Construct the Task deliberately

Task fieldValueMapping type
Task NameProject kickoff — + Project NameLiteral plus reference
Due DateTarget DateDate reference
StatusOpenLiteral
Assigned ToProject Manager → IDStructured user reference
Related ProjectProject Record IDNumeric relationship reference

Literal + reference

Task Name combines fixed text with the runtime Project Name.

Project kickoff — Application Review Project

Typed reference

Target Date maps directly into Due Date, preserving its date meaning.

Literal policy

Open does not come from the Project. It enforces the intended initial Task state.

A User is structured identity

When Project Manager was Text, it exposed text-like data. After changing it to a User field, the reference picker exposed ID, first name, last name, email, and screen name.

Map Project Manager → ID into Assigned To.

Match the meaning and structure of the source to the destination, not merely what the displayed value resembles.

Create the relationship

Map Project Record ID into Task → Related Project. The child stores the parent key; Quickbase then resolves Project Name, Project Status, and Project Target Date through the relationship.

Pipeline responsibility

Establish Related Project.

Quickbase responsibility

Maintain the relationship lookup values.

Controlled tests

Negative and positive controls

On Hold

OBSERVED
  • The Record Updated trigger ran.
  • The condition evaluated false.
  • Create Record did not run.
  • No Task was created.
  • The pipeline finished without error.

Intentionally doing nothing is valid behavior.

Active

OBSERVED
Record ID46
Task NameProject kickoff — Application Review Project
Due DateNovember 30, 2026
StatusOpen
Assigned ToUser ID 3
Related ProjectProject Record ID 2

Verify the business result first.

Confirm the Task and its relationship in the Tasks table. The Activity Log supports that verification; it does not replace it.

Capture the new identity

Create Record returned id: 46

Task 46 did not exist before the action ran. The trigger supplied the source Project identity; Create Record supplied the new Task identity.

Source Project

Record ID from trigger

Stored in the Task’s Related Project field

New Task

Record ID from Create Record

Available to every later step

Multi-record UI save experiment

One save produced two independent runs

Two Projects were changed to Active and saved together. The Record Updated trigger remained record-oriented; it did not deliver one combined collection to the pipeline.

Source ProjectCreated Task IDRelated Project
Training Documentation Refresh473
November Reporting Cycle481

Boundary for a later lesson

These were two record-triggered executions, not one bulk event. On New Bulk Event will receive its own controlled investigation.

Two concise Activity reviews

Enough evidence—without digital archaeology

Review 1

Did the branch behave correctly?

TestConditionCreate Record
On HoldFalseDid not run
ActiveTrueRan

Review 2

What entered and left Create Record?

Input

Task Name, Due Date, Status, Assigned To, Related Project

Output

New Record ID, saved values, created and updated timestamps

Queue behavior, webhook transport, and deeper lifecycle semantics remain outside this lesson unless an unexplained result requires an addendum.

Create Record means insert

Create Record does not inherently ask whether a matching Task already exists. If the qualifying path executes again, another Task can be created unless the workflow has a duplicate-prevention rule.

Search before creationCreated-state flagRelated-record checkUnique key and upsertDedicated idempotency rule

These safeguards are architectural signposts, not additional Lesson 20 experiments.

Evidence ledger

What the lab established

ClassificationFinding
DOCUMENTEDCreate Record inserts a record into the selected Quickbase table.
DOCUMENTEDSelected fields determine which values the action writes.
DOCUMENTEDPrior-step references can supply runtime values.
DOCUMENTEDThe action exposes output from the newly created record.
OBSERVEDA Project changing to On Hold followed the false branch.
OBSERVEDA Project changing to Active created a related Task.
OBSERVEDCreate Record returned the new Task identity: Record ID 46.
OBSERVEDA User field exposed structured identity properties.
OBSERVEDProject Manager ID successfully populated Assigned To.
OBSERVEDProject Record ID successfully populated Related Project.
OBSERVEDTwo Projects changed in one UI save produced separate runs.
OBSERVEDThose runs created Tasks 47 and 48 with the correct source context.
INFERREDA repeated qualifying event may create another Task unless duplicate prevention is added.
INFERREDThe returned Task ID can become input to later actions, although this lesson stops after observing it.

Common misconceptions

“Create Record copies the source record.”

No. It constructs a new destination record from explicitly mapped values.

“Project Name establishes the relationship.”

No. Related Project receives the parent Project Record ID.

“Assigned To should receive the displayed manager name.”

Use the structured User ID when dependable identity is available.

“The pipeline must write every Project lookup field.”

Set Related Project and allow Quickbase to resolve its lookup fields.

“A false condition means the pipeline failed.”

The pipeline evaluated the rule and correctly skipped the action.

“Two changed Projects produce one Create Record action.”

Our test produced two independent record-oriented runs.

“The new Task uses the Project ID as its own ID.”

The Project ID becomes Related Project; Quickbase generates a new Task ID.

Final mental model

Source, decision, creation, identity

A trigger provides the source record and its existing identity. A condition decides whether creation is appropriate. Create Record constructs a new record from literals and references. Quickbase assigns the new record its own identity, while a mapped reference field connects it to the source record.

Lesson 20 knowledge check

Answer each question before opening its explanation.

1. What makes the new Task a child of the triggering Project?
Answer: Mapping the Project Record ID into Related Project. The reference field stores the parent Project’s identity.
2. Why was Project Manager changed from Text to User?
Answer: A User field exposes structured identity values such as ID. Assigned To needs a Quickbase user identity, not merely displayed text.
3. True or False: The pipeline should manually populate every Project lookup field on the new Task.
Answer: False. Once Related Project is assigned, Quickbase resolves those lookup values through the relationship.
4. What is the difference between the two Record IDs in this lesson?
Answer: The Project Record ID identifies the source parent and is stored in Related Project. The Task Record ID is generated after Quickbase creates the new child.
5. True or False: A false condition means the pipeline failed.
Answer: False. The pipeline ran and correctly declined to create a record.
6. What happened when two Projects were activated in one UI save?
Answer: Two separate record-oriented runs created one related Task each. The runs retained their own Project contexts.
7. What risk exists if the same qualifying event occurs again?
Answer: Another Task may be created unless the pipeline includes a duplicate-prevention or idempotency rule.

Lesson 20 is complete when…

  • A non-Active Project creates no Task.
  • An Active Project creates one mapped Task.
  • Assigned To receives a valid user.
  • Related Project identifies the source Project.
  • Relationship lookup fields populate.
  • Create Record returns the Task Record ID.
  • Multiple qualifying updates are understood as independent record-oriented runs.

Ready for Lesson 21?

Tasks 46, 47, and 48 now give the next lab disposable records for studying Delete Record: target identity, controlled deletion, and verification of what no longer exists.

Lesson 19Lessons pageContinue to Lesson 21