Skip to content


Get your token

Send your email and password to receive your access token. Your access token will be used to add Buckets to your account as well as other account-related access. Sign up to set up your Cosmic account.

If you signed up using a 3rd party (Google or GitHub) you can create a new password in Account Settings > Password.

You do not need to use the token to access your Bucket content. Your Bucket has its own read and write keys for restricted access. See the API introduction to learn how to get your Bucket access keys.

emailrequiredStringYour Cosmic login email
passwordrequiredStringYour Cosmic login password



Example Request

const Cosmic = require("cosmicjs")(); // double parentheses to init function without token
const data = await Cosmic.authenticate({
email: "",
password: "yourpassword",

Example Response

"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXV.eyJlbWFpbCI6InNwaXJvbnl..."

Use your token

You can use the Authentication token using REST requests to the API

Example -> Get Buckets

token must be passed as Authorization Bearer in the header of the request.



Example Request

const Cosmic = require("cosmicjs")({
token: "your-token-from-auth-request", // optional
const data = await Cosmic.getBuckets();