How to create folk person in Folk

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
Group ID group_id	string	Required	The Group ID assigned by Folk. Find via the corresponding list/search operation in this app. Use the exact ID, not a name or label.
Full Name fullName	string	Required	–
Emails (array of strings) emails	array	Optional	–
Phone numbers (array of strings) phones	array	Optional	–
Description description	string	Optional	–
Job Title jobTitle	string	Optional	–
Company Name companyName	string	Optional	–

Sample request

{
  "group_id": "{{trigger.group_id}}",
  "fullName": "{{trigger.fullName}}",
  "emails": "{{trigger.emails}}",
  "phones": "{{trigger.phones}}",
  "description": "{{trigger.description}}"
}

Returns

{
  "id": "person_abc",
  "emails": [
    "jane@acme.com"
  ],
  "fullName": "Jane Doe",
  "jobTitle": "CEO"
}

Use these fields in downstream nodes for routing, logging, or error handling.

FAQ

Questions about Create Folk Person.

What does the Create Folk Person action do in Folk?

Creates a person record with email, name, company association, custom fields. The base hook for "form submission → push to Folk" sync workflows in relationship-driven agencies and consultancies.

What inputs does Create Folk Person require?

Required: Group ID, Full Name. Every input accepts a static value or a variable from any upstream node in your workflow.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if Folk returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does Create Folk Person support batch operations?

Yes. Run Create Folk Person inside a Loop node to process arrays. TinyCommand handles Folk's rate limits automatically so you don't have to throttle manually.

More actions