Skip to content

docs(flatfile): add 'Create a secret key' section with API-key creation GIF#614

Open
caiopizzol wants to merge 1 commit into
amp-labs:mainfrom
caiopizzol:caiopizzol/add-flatfile-secret-key-guide
Open

docs(flatfile): add 'Create a secret key' section with API-key creation GIF#614
caiopizzol wants to merge 1 commit into
amp-labs:mainfrom
caiopizzol:caiopizzol/add-flatfile-secret-key-guide

Conversation

@caiopizzol
Copy link
Copy Markdown
Contributor

@caiopizzol caiopizzol commented May 18, 2026

Description

flatfile.mdx previously had no "Before you get started" section walking a user through credential creation — it jumped straight from supported actions/objects to "Using the connector," leaving readers to figure out where to get a key. This adds a narrow Create a Flatfile secret key section mirroring the structure already used in monday.mdx and instantly.mdx.

Wording chosen carefully:

  • Uses Flatfile's own terminology: Secret key (vs Publishable key), per Flatfile's auth docs. Server-side access through Ampersand uses the Secret key.
  • Step labels intentionally generic ("Navigate to your developer or API key settings") because Flatfile's nav labels have shifted over time. The GIF carries the precise current UI.

Asset: flatfile-api-key.gif compressed via gifsicle -O3 --lossy=300 --colors 64 --scale 0.7 to 0.84 MB at 494×336, which sits inside the existing api-key GIF size range in the repo (1.2–2.6 MB for similar assets).

Out of scope: the Supported Actions/Objects section is untouched. The sample-link reference in "Using the connector" was already resolved by amp-labs/samples#132 (now merged); no docs change needed there.

Screenshot

image

…on GIF

flatfile.mdx previously had no 'Before you get started' section
walking users through credential creation. Adds a narrow section
mirroring the structure used in other API-key provider guides
(monday, instantly).

- Uses Flatfile's own terminology (Secret key vs Publishable key).
- Step labels intentionally generic; the GIF carries the precise UI.
- 0.84 MB compressed GIF at 494x336 (gifsicle -O3 --lossy=300
  --colors 64 --scale 0.7), well within the existing api-key GIF
  size range.

References Flatfile's authentication documentation rather than
restating it.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant