Troubleshooting submissions
If a submission shows a failed status, here is how to diagnose and fix it.
Reading the error details
Click any failed submission in the submissions table. The detail panel shows:
- Error code — the specific error returned by the Attio API
- Error message — a human-readable description
- Raw payload — the exact data that was sent to Attio
Start with the error message — it usually identifies the problem directly.
Common errors and fixes
Attribute not found
An attribute referenced in the submission does not exist on the Attio object. This happens when:
- An attribute was renamed or deleted in Attio after the form was published.
- The form was built against a different object than expected.
Fix: Go to the form builder, click Refresh schema, then review and re-save field configurations.
Invalid attribute value
The submitted value is not valid for the attribute type. Common causes:
- A number field received a string value.
- A select field received a value that is not a valid option.
- A date field received an unparseable date string.
Fix: Review the field type mapping in the builder. Ensure the correct field type is selected for each attribute.
Token expired or Unauthorized
The Attio OAuth token has expired or been revoked.
Fix: Go to Settings → Workspace and click Reconnect. Go through the OAuth flow again. All future submissions will use the new token.
Rate limit exceeded
Your workspace is sending too many API requests. Attio Forms automatically retries rate-limited submissions with exponential back-off.
Fix: No immediate action required. If rate limiting is persistent, check whether multiple forms are generating high submission volumes simultaneously.
Record not writable
The target record exists but cannot be updated (e.g. it is archived or locked by another system).
Fix: Check the record status in Attio. Unarchive or unlock the record if appropriate.
Retry behaviour
Failed submissions are automatically retried up to 3 times:
- First retry: 5 minutes after failure
- Second retry: 30 minutes after failure
- Third retry: 2 hours after failure
After 3 failed attempts the submission is marked permanently_failed and no further retries occur. You can still trigger a manual retry from the dashboard at any time.
Contacting support
If you cannot diagnose the issue, contact support with:
- The form ID (visible in the URL:
/dashboard/forms/) - The submission ID (visible in the submission detail panel)
- The error message
We can inspect the server-side logs for any submission.