🔏
API Docs
  • Beam API Docs
  • Overview
    • About Beam
    • API Requirements
    • Roles and Permissions
  • Getting Started
    • Requesting an Account
    • Using RESTful Tools
    • Webhooks
  • The Basics
    • Entities
    • Best Practices
    • Testing Accounts
  • OAuth
    • Overview
    • How to Authorize Access
      • Step 1: Generate Authorization URL
      • Step 2: Handle Authorization Response
      • Step 3: Request an Access Token
      • Step 4: Call API Endpoints
      • Step 5: Refresh the Tokens
  • API Endpoints
    • Overview
    • Get User Devices
    • Toggle Door
    • Invite User (internal)
    • Get Toggle History
    • Get User Info
    • Get User Settings
Powered by GitBook
On this page
  1. OAuth
  2. How to Authorize Access

Step 4: Call API Endpoints

PreviousStep 3: Request an Access TokenNextStep 5: Refresh the Tokens

Last updated 4 years ago

Now that you have a valid access_token, you can start using the Beam API. To make an authenticated request of one of the Beam API endpoints, the Authorization header must be supplied:

POST /api/oauth/v1/endpoints/sync  HTTP/1.1
Host: https://garageio.com
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>
Accept-Charset: utf-8
Accept-Encoding: gzip

where <ACCESS_TOKEN> is a valid access token for the given user. The Beam service will return with a JSON response.

Hint: All Beam API endpoints accept JSON bodies in the request and/or return JSON bodies in the responses.

Using a prototype tool to test? If you are using a tool, such as POSTMAN to test, read section for known issues.

Using RESTful Tools