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:

1. Creates or updates a record on the list's parent object (using the same de-duplication logic above).
2. 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.

Related object fields

Forms can include fields from related Attio objects — for example, a People form can include Company attributes. When the form is submitted, Attio Forms creates or updates the linked record on the related object and sets up the relationship between the two records automatically.

This lets you collect data across multiple Attio objects in a single form without asking respondents to fill out separate forms.

Queued submissions

When a workspace reaches its monthly submission limit, new submissions are saved with a QUEUED status rather than being synced to Attio immediately. Queued submissions:

• Are stored safely in Attio Forms and are not lost.
• Are not written to Attio until the workspace upgrades to a higher plan or until the submission count resets at the next billing period.
• Can be manually retried by a workspace admin from the Submissions dashboard once capacity is available.

To avoid queuing, upgrade your plan before hitting the limit. Attio Forms sends a warning email when your workspace reaches 80% of its monthly submission allowance.

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.