diff --git a/docs/integrations/builtin/app-nodes/n8n-nodes-base.airtable/common-issues.md b/docs/integrations/builtin/app-nodes/n8n-nodes-base.airtable/common-issues.md new file mode 100644 index 00000000000..b747589096d --- /dev/null +++ b/docs/integrations/builtin/app-nodes/n8n-nodes-base.airtable/common-issues.md @@ -0,0 +1,31 @@ +--- +#https://www.notion.so/n8n/Frontmatter-432c2b8dff1f43d4b1c8d20075510fe4 +title: Airtable node common issues +description: Documentation for common issues and questions in the Airtable node in n8n, a workflow automation platform. Includes details of the issue and suggested solutions. +contentType: integration +priority: high +--- + +# Airtable node common issues + +Here are some common errors and issues with the [Airtable node](/integrations/builtin/app-nodes/n8n-nodes-base.airtable/) and steps to resolve or troubleshoot them. + +## Forbidden - perhaps check your credentials + +This error displays when trying to perform actions not permitted by your current level of access. The full text looks something like this: + +``` +There was a problem loading the parameter options from server: "Forbidden - perhaps check your credentials?" +``` + +The error most often displays when the credential you're using doesn't have the scopes it requires on the resources you're attempting to manage. + +Refer to the [Airtable credentials](/integrations/builtin/credentials/airtable/) and [Airtables scopes documentation](https://airtable.com/developers/web/api/scopes) for more information. + +## Service is receiving too many requests from you + +Airtable has a hard API limit on the number of requests generated using personal access tokens. + +If you send more than five requests per second per base, you will receive a 429 error, indicating that you have sent too many requests. You will have to wait 30 seconds before resuming requests. This same limit applies for sending more than 50 requests across all bases per access token. + +You can find out more in the [Airtable's rate limits documentation](https://airtable.com/developers/web/api/rate-limits). If you find yourself running into rate limits with the Airtable node, consider implementing one of the suggestions on the [handling rate limits](/integrations/builtin/rate-limits/) page. diff --git a/docs/integrations/builtin/app-nodes/n8n-nodes-base.airtable.md b/docs/integrations/builtin/app-nodes/n8n-nodes-base.airtable/index.md similarity index 94% rename from docs/integrations/builtin/app-nodes/n8n-nodes-base.airtable.md rename to docs/integrations/builtin/app-nodes/n8n-nodes-base.airtable/index.md index fe2b1b970d4..2dd93558cc8 100644 --- a/docs/integrations/builtin/app-nodes/n8n-nodes-base.airtable.md +++ b/docs/integrations/builtin/app-nodes/n8n-nodes-base.airtable/index.md @@ -55,6 +55,7 @@ To get the Record ID of your record, you can use the **List** operation of the A ### Filter records when using the List operation To filter records from your Airtable base, use the **Filter By Formula** option. For example, if you want to return all the users that belong to the organization `n8n`, follow the steps mentioned below: + 1. Select 'List' from the **Operation** dropdown list. 2. Enter the base ID and the table name in the **Base ID** and **Table** field, respectively. 3. Click on **Add Option** and select 'Filter By Formula' from the dropdown list. @@ -64,8 +65,6 @@ Similarly, if you want to return all the users that don't belong to the organiza Refer to the Airtable [documentation](https://support.airtable.com/hc/en-us/articles/203255215-Formula-Field-Reference){:target=_balnk .external-link} to learn more about the formulas. +## Common issues - - - - +For common errors or issues and suggested resolution steps, refer to [Common Issues](/integrations/builtin/app-nodes/n8n-nodes-base.airtable/common-issues/). diff --git a/mkdocs.yml b/mkdocs.yml index 603ba39523a..be5f36b8662 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -444,7 +444,9 @@ nav: - Adalo: integrations/builtin/app-nodes/n8n-nodes-base.adalo.md - Affinity: integrations/builtin/app-nodes/n8n-nodes-base.affinity.md - Agile CRM: integrations/builtin/app-nodes/n8n-nodes-base.agilecrm.md - - Airtable: integrations/builtin/app-nodes/n8n-nodes-base.airtable.md + - Airtable: + - Airtable: integrations/builtin/app-nodes/n8n-nodes-base.airtable/index.md + - Common issues: integrations/builtin/app-nodes/n8n-nodes-base.airtable/common-issues.md - AMQP Sender: integrations/builtin/app-nodes/n8n-nodes-base.amqp.md - APITemplate.io: integrations/builtin/app-nodes/n8n-nodes-base.apitemplateio.md - Asana: integrations/builtin/app-nodes/n8n-nodes-base.asana.md