Attio record creation
When a form is submitted, Attio Forms writes the data back to your Attio workspace. The exact behaviour depends on your form's source type.
Object forms
For forms backed by an Attio object (e.g. People, Companies), Attio Forms either creates a new record or updates an existing one.
De-duplication
Attio Forms checks for an existing record before creating a new one. De-duplication uses the email address and domain fields when they are present in the submission. If a record with the same email or domain exists, Attio Forms updates it. If not, a new record is created.
If neither an email nor a domain field is included in the form, every submission creates a new record.
Field mapping
Each visible field in the form maps to an Attio attribute by its slug. Hidden fields with default values (configured in the builder) are also written.
List forms
For forms backed by an Attio list, every submission:
- Creates or updates a record on the list's parent object (using the same de-duplication logic above).
- Adds a list entry for that record in the target list.
Each submission creates a new list entry, even if the record already has an existing entry in the list.
Attio write errors
The most common causes of write failures:
| Error | Likely cause |
|---|---|
Attribute not found | The attribute was deleted in Attio after the form was built. Refresh schema in the builder. |
Invalid value | The submitted value does not match the Attio attribute type. Check field type mapping. |
Permission denied | The OAuth token lacks write permission. Reconnect your workspace from Settings. |
Rate limit exceeded | Too many submissions in a short window. Try again shortly. |