--- title: Unified Forms API — Truto Unified API slug: forms canonical: "https://truto.one/unified-apis/forms/" --- # Surveys & Forms Unified API Integrate Surveys & Forms data across 7 providers with one API. 9 normalized resources, real-time pass-through, fully customizable. **Base URL:** `https://api.truto.one/unified/forms` **Resources:** 9 **Integrations:** 7 ## Resources ### Collections (9 fields) - `id` (string) — The unique identifier for a collection - `name` (string) — The name of the collection - `description` (string) — The description of the collection - `type` (string) — The type of the collection - `parent_collection_id` (string) — The parent collection id - `urls` (array) — The URLs of the collection - `workspace` (object) — - `created_at` (string) — The date and time when the collection was created - `updated_at` (string) — The date and time when the collection was updated ### Contacts (13 fields) - `id` (string) — The contact's unique identifier - `first_name` (string) — The contact's first name - `last_name` (string) — The contact's last name - `name` (string) — The contact's full name - `title` (string) — The contact's job title - `account` (object) — The contact's account - `addresses` (array) — - `email_addresses` (array) — - `phone_numbers` (array) — - `tags` (array) — The contact's tags - `last_activity_at` (string) — The date and time of the contact's last activity - `created_at` (string) — The date and time of the contact's creation - `updated_at` (string) — The date and time of the contact's last update ### Fields (17 fields) - `id` (string) — The field's unique identifier - `name` (string) — The field's name. This is the name of the property in the entity. - `label` (string) — The field's label - `placeholder` (string) — The field's placeholder - `description` (string) — The field's description - `position` (number) — The index position of field in the form. - `type` (string) — The field's type. If no clear mapping exists, then raw value is returned. - `format` (string) — The format of the field. - `validation` (string) — The validation string for the field. - `range` (object) — The range applicable for field types number, rating, scale. - `is_required` (boolean) — Whether the field is required - `options` (array) — The field's options - `field_group` (object) — The field's group identifier. If present, the field is part of a group. - `rows` (array) — The field's rows. If present, the field's type is matrix - `columns` (array) — The field's columns. If present, the field's type is matrix - `created_at` (string) — The date and time of the field's creation - `updated_at` (string) — The date and time of the field's last update ### Forms (9 fields) - `id` (string) — The unique identifier of the form. - `name` (string) — The name of the form. - `type` (string) — The type of the form. - `fields` (array) — The form fields - `workspace` (object) — The workspace to which the form belongs. - `organization` (object) — The organization to which the workspace belongs. - `last_submitted_at` (string) — The date and time when the form was last submitted. - `created_at` (string) — The date and time when the form was created. - `updated_at` (string) — The date and time when the form was last updated. ### Groups (7 fields) - `id` (string) — Unique identifier for the group. - `name` (string) — Name of the group. - `description` (string) — Description of the group. - `organization` (string) — Unique identifier for the organization the group belongs to. - `group_type` (string) — Type of the group. - `created_at` (string) — Date and time when the group was created. - `updated_at` (string) — Date and time when the group was last updated. ### Organizations (4 fields) - `id` (string) — Unique identifier for the organization. - `name` (string) — Name of the organization. - `created_at` (string) — Date and time when the organization was created. - `updated_at` (string) — Date and time when the organization was last updated. ### Responses (11 fields) - `id` (string) — The unique identifier of the response. - `name` (string) — The name of the response. - `status` (string) — The status of the form response. - `answers` (array) — The answers submitted - `created_by` (object) — User who created the response. - `form` (object) — The form to which the response belongs. - `workspace` (object) — The workspace to which the response belongs. - `organization` (object) — The organization to which the response belongs. - `opened_at` (string) — The date and time when the form was opened. - `created_at` (string) — The date and time when the response was created. - `updated_at` (string) — The date and time when the response was last updated. ### Users (25 fields) - `id` (string) — The unique identifier for a member - `first_name` (string) — The first name of the member - `last_name` (string) — The last name of the member - `title` (string) — The title of the member - `name` (string) — The name of the member - `username` (string) — The username of the member - `emails` (array) — The emails of the member - `phones` (array) — The phones of the member - `status` (string) — The status of the member. If no clear mapping is available, then the raw value is returned. - `is_email_verified` (boolean) — Whether the member's email has been verified - `organizations` (array) — The organizations of the member - `workspaces` (array) — The workspaces of the member - `groups` (array) — The groups of the user - `type` (string) — The type of member - `avatar` (string) — The avatar of the member - `timezone` (string) — The timezone of the member - `languages` (array) — The languages preferred by the member - `bio` (string) — The bio of the member - `created_at` (string) — The date and time the member was created - `updated_at` (string) — The date and time the member was last updated - `last_active_at` (string) — The date and time the member was last active - `last_login_at` (string) — The date and time the member was last logged in - `status_changed_at` (string) — The date and time the member's status was last changed - `activated_at` (string) — The date and time the member was activated - `urls` (array) — The URLs of the member ### Workspaces The Workspace object is used to represent a workspace in the e-sign application. (6 fields) - `id` (string) — The unique identifier of the workspace. - `name` (string) — The name of the workspace. - `type` (string) — The type of the workspace. - `organization` (object) — The organization to which the workspace belongs. - `created_at` (string) — The date and time when the workspace was created. - `updated_at` (string) — The date and time when the workspace was last updated. ## Supported integrations - [Google](https://truto.one/integrations/detail/google/) - [Google Forms](https://truto.one/integrations/detail/googleforms/) - [Jotform](https://truto.one/integrations/detail/jotform/) - [Survey Monkey](https://truto.one/integrations/detail/surveymonkey/) - [SurveySparrow](https://truto.one/integrations/detail/surveysparrow/) - [Typeform](https://truto.one/integrations/detail/typeform/) - [Webflow](https://truto.one/integrations/detail/webflow/)