1

Provision your Platform

A Platform is Teal’s representation of your business, with its own configuration, data, and users. All of Teal’s APIs operate within the scope of a Platform.

We provision your Platform for you. If you do not already have a provisioned Platform, reach out to your Teal contact or visit the Teal home page to get in touch.

2

Create a developer account

Once we have provisioned your Platform, you can access our Developer Portal. You will need to create an account using your company email address.

3

Generate a Sandbox API token

Tokens should always be kept secret. Don’t share outside of your organization and be careful when sharing within.

Calls to our API are authenticated using a bearer token and are sent to our API using an Authentication: Bearer <token> HTTP header.

You can create which can create and manage these tokens in the Developer Portal. Tokens are unique to your Platform and to the API environment.

We support two different API environemnts:

  • Sandbox: https://api.sandbox.teal.dev
  • Production: https://api.teal.dev

Our sandbox environment is separate from our production environment. Sandbox is intended to be used during development.

4

Call the API

Test that you are setup to access the API by making a test call. Run the following cURL command in your client or use the API Reference in our docs. Replace <API token> with the appropriate values for your sandbox Platform.

Shell
curl --location --request GET 'https://api.sandbox.teal.dev/v0/platform' --header 'Authorization: Bearer <API token>'

If successful, you should see a response that looks like the following:

JSON
{
  "id": 12345,
  "name": "Platform Name"
}