Step 1: Authentication

Environments

There are two different environments available to partners. Each environment uses a different base URL.

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

Authentication

Triple uses OAuth for authentication (machine-to-machine/server-to-server). After succesful onoboarding your Triple contact will have provided you with the clientId and clientSecret for both sandbox and production environments. User the clientId and clientSecret to obtain an access_token. By default, the access_token is valid for 3,600s

curl --location 'https://auth.tripleup.dev/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic {clientId}:{clientSecret}' \
--header 'Cookie: XSRF-TOKEN=5b367412-3873-499a-b615-d5661505de5e' \
--data-urlencode 'grant_type=client_credentials'

tip

Note the usage of Content-Type: application/x-www-form-urlencoded and the body of grant_type=client_credentials

Conventions

Action	Description
GET	Used to retrieve a representation of a resource.
POST	Used to create new resources and sub-resources.
PATCH	Used to update existing resources.
DELETE	Used to delete existing resources.