diff --git a/.all-contributorsrc b/.all-contributorsrc
index e1ab695f4..02ba120f7 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -210,6 +210,7 @@
"profile": "http://brianjon.es",
"contributions": [
"code",
+ "doc",
"bug",
"ideas"
]
diff --git a/.changeset/dull-items-battle.md b/.changeset/dull-items-battle.md
new file mode 100644
index 000000000..178e20646
--- /dev/null
+++ b/.changeset/dull-items-battle.md
@@ -0,0 +1,5 @@
+---
+"gatsby-source-airtable": patch
+---
+
+Update documentation on API key creation
diff --git a/README.md b/README.md
index 2145de5d2..37f8551b3 100644
--- a/README.md
+++ b/README.md
@@ -68,7 +68,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
Jacob Bolda 🔌 💻 📖 👀 💬 🤔 💡 🐛 |
Brendan McGill 💻 📖 💡 🐛 |
James Simone 💻 📖 🐛 💬 👀 |
- Brian Jones 💻 🐛 🤔 |
+ Brian Jones 💻 🐛 🤔 📖 |
Christopher Blow France 📖 🐛 |
Eunjae Lee 💻 📖 |
diff --git a/packages/gatsby-source-airtable/README.md b/packages/gatsby-source-airtable/README.md
index b39e6c3db..35bd075be 100644
--- a/packages/gatsby-source-airtable/README.md
+++ b/packages/gatsby-source-airtable/README.md
@@ -243,7 +243,9 @@ underscores.
### API Keys
-Keys can be found in Airtable by clicking `Help > API Documentation`.
+Airtable has moved from using a single API key per user to using personal access tokens that carry specific privileges limited to specific bases and workspaces. The personal API keys will be deprecated by the end of January 2024. The personal access tokens can be used interchangeably with the older API keys.
+
+To create a new token, go to the [Personal Access Tokens](https://airtable.com/create/tokens) panel of the [Developer Hub](https://airtable.com/developers). `gatsby-source-airtable` requires the `data.records:read` scope on any base(s) from which you’ll be pulling data. You’ll need the full Token shown to you only one time on creation, not the truncated Token ID shown in the table of all Personal Access Tokens. Once you have this token value, use it as the API key in the configuration outlined below.
The API key can be hard coded directly in `gatsby-config.js` as noted in the
previous section-- **this exposes your key to anyone viewing your repository and