Credentials
Log in to your free test account, or go live via sales.
Credentials are a 6-digit client reference and a client secret, issued per environment. Start with a test account: it's free, it's yours, and nothing on it is billed.
Your test account
Connect the CLI to your test account:
The CLI opens the partner area and shows a code. Type that code on the page
and approve. The CLI gets a login session that lasts 90 days, keeps it in your
OS keychain, and verifies it with a catalog call. Your client secret stays in
the partner area. firsty logout ends the session, and you can revoke it from
the partner area at any time.
Prefer your coding agent to do the whole setup? Paste the prompt from the top of the documentation overview. It reads agents.md and runs the same flow.
Using the credentials directly
The CLI is optional. Your test account's client reference and secret are on the API page of the partner area, and anything that can make an HTTP call can use them:
Exchange them for a bearer token as shown in
Authentication, or shortcut
with firsty auth token.
Keep the secret out of client code and version control.
Going live
Live credentials are issued for connect.firsty.app, with your commercial
catalogue attached. Talk to sales to go live.