Recipients & Pre-fill
Add recipients to a form with optional pre-filled answers.
Recipients
A recipient is a person invited to fill out a form. Each recipient gets a unique link and optionally pre-filled answers.
/api/v1/forms/{id}/recipients/api/v1/forms/{id}/recipientsCreate a recipient with optional pre-fill
/api/v1/forms/{id}/recipients/{rid}Update a recipient
/api/v1/forms/{id}/recipients/{rid}Delete a recipient
Create a recipient
| Name | Type | Description |
|---|---|---|
| label | string | Display name for the recipientJohn Doe |
| Triggers invitation email if a mail integration is configured | ||
| phone | string | Phone number (for SMS notifications if configured) |
| password | string | Password-protect the form link (min 4 chars) |
| expires_at | datetime | ISO 8601 expiry — link becomes inactive after this time |
| prefill | object | Map of question ID or exact question text → value. Saves responses immediately. |
Pre-filling answers
The prefill field accepts a map of question IDs or exact question text to values. The API saves these as Response records immediately — the recipient will see the answers pre-populated when they open the link.
If multiple questions have the same exact text, a text-key prefill applies to all matching questions. If two keys resolve to the same question, the request is rejected.
curl -X POST https://app.formalingo.com/api/v1/forms/FORM_ID/recipients \
-H "Authorization: Bearer af_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"label": "John Doe",
"email": "john@acme.com",
"expires_at": "2026-03-31T23:59:59Z",
"prefill": {
"question-uuid-1": "John Doe",
"Company": "Acme Corp",
"Email": "john@acme.com"
}
}'{
"success": true,
"data": {
"id": "recipient-uuid",
"form_id": "form-uuid",
"label": "John Doe",
"email": "john@acme.com",
"token": "abc123",
"status": "not_started",
"is_active": true,
"is_anonymous": false,
"has_password": false,
"link": "https://www.formalingo.com/f/abc123",
"response_count": 3,
"visit_count": 0,
"total_questions": 5,
"created_at": "2026-02-25T10:00:00.000Z"
}
}The recipient link
The link field in the response is the URL the recipient uses to fill out the form. Share this via email, embed it in your application, or use it for redirects.