Skip to content

Authentication and authorisation

Joining an organisation

Some APIs are published privately and require you to create an account and login before you can use them. If you do not yet have a Sheetlabs account, then you should:

  1. Register with Sheetlabs and enter your details.
  2. Select the option to Join An Existing Organisation, and enter the organisation code that you want to access.
  3. Wait for one of the administrators of the organisation to approve your request. You will receive an email once approved.

Once you have joined an organisation then you will be able to view the API documentation and make calls to the APIs.

Making authenticated API calls

Authenticated APIs should be called with HTTP Basic Authentication. Examples are shown on the API documentation page.

You should use your Sheetlabs username (your email address) and password in API calls. You can also use an authentication token instead of your password.

To view your current API auth token, click Account on the menu bar, and then My Account. An API auth token will look something like t_3203b31b16df39c43f6a90d670f01f0e.

You can make an API request with your authentication token with a command like this:

curl -u "user@example.com:t_3203b31b16df39c43f6a90d670f01f0e" https://sheetlabs.com/ACME/getDomain

If your authentication token is accidentally leaked, then you should generate a new one. You can generate a new API auth token at any point from the My Account page. This will invalidate your existing auth token, but will have no effect on your account’s password.