Create card

Creates a new card (deal) in a flow, from the fields defined in the flow's entry form (start-form).

The request body contains only the list of filled-in fields, each identified by its identifier (UUID) — never by the field's name or slug. The value's shape depends on the field type: plain text is a string; selection fields, even single-choice ones, expect an array with the selected value(s); client-document fields expect an array of objects containing the document (tax id, digits only), the person type (natural for an individual or legal for a company), the client's name, and a variant indicator (1 for an individual, 2 for a company) — present in each array element, not at the payload's root level.

The created card is automatically placed in the flow's initial phase. Labels applied by automations configured on the flow may not be reflected immediately in this call's response: reading labels right afterwards may return an empty list for a short interval, even when the label has already been or is about to be applied.

{ "id": "string", "flowId": "string", "currentPhaseId": "string", "title": "string", "value": 0, "done": true, "assignee": { "userId": "string", "userName": "string", "userEmail": "string" }, "labels": [ { "label": "string", "color": "string" } ], "fields": [ { "id": "string", "value": null } ], "createdAt": "string" }

Requisição

Respostas