CohabitDeveloper Portal
Docs menu · Creating your first project

Creating your first project

Your Dashboard has two separate kinds of "project" — pick the one that matches what you're building. Most people building against the product API only need the first one.

API projects — for the product API

A container for your product API keys (X-API-Key). No OAuth setup involved.

  1. Log in and open your Dashboard.
  2. Under API projects, click Create project and give it a name.
  3. Under API keys, pick that project and click Create key — your key is shown once in full.

Keep the key private: send it only in a server-side X-API-Key header, never from browser or mobile code. If you lose it, revoke it and create a new one from the same panel.

OAuth clients — for "Login with Cohabit"

Only needed if your own app will let users log in via Cohabit Authentication. Each OAuth client gets its own client_id and client_secret, plus a redirect URI your application uses to receive the authorization code.

  1. Under OAuth clients, click Create project, give it a name, and add the redirect URI(s) your application will use.
  2. Save — your client_id and client_secret are generated immediately.

Keep your client_secret private. It's shown once in full; after that, the dashboard only shows a masked value.

What you can do with these credentials

An OAuth client's credentials let your application authenticate against Cohabit Authentication using the authorization code flow, so users can log in and grant your application access on their behalf. This is unrelated to calling the product API — that only needs an API project's key, above.