Requesting an Account

Before you can attempt to make authenticated request, you must first register your application with the Beam service by emailing Beam Support at [e-mail]. Garageio will then generate an account and return the credentials (a client_id and client_secret) to the developer contact email.

You must supply beam with the following:

• Developer Contact Information

  • Name

  • Email address

• Company/Product Name (eg. Google)

• Company/Product Website URL (eg. https://google.com)

• Application Name (can be same as company/product name)

• Description of Application (can be same as company/product desc.)

• Website URL of Application (if different than Website URL)

• Your Redirect/Callback URL for OAuth (e.g. https://mysaasproduct.com/oauth/v1/authorize)

A Note about Mulitple Environments - Most applications have multiple environments (eg. development, certification, production, etc.). If your application has more than one environment, you must supply the additional information for each environment as separate credentials will need to be created for each. Supply the following for each different environment:

• URL for application (eg. qa.example.com)

• Redirect/callback URL for OAuth

Example Request Email

Please use the following format to compose the email and send it to [e-mail]:

Dear Support,

I am requesting OAuth credentials for the below application.

Name of Developer Contact: John Doe Email Address of Developer Contact: [e-mail] Name of Company/Product: MyHome Inc. Website Address of Company/Product: https://myhomeapp.com Name of Application: MyHome Description of Application: MyHome allows users to monitor who is home and send notifications when someone leaves or returns.

MyHome has two environments, DEV and PROD.

For DEV:

Website Address of the Application: https://dev.myhomeapp.com Redirect or Callback OAuth URL: https://dev.myhomeapp.com/oauth/v1/authorize

For PROD:

Website Address of the Application: https://myhomeapp.com Redirect or Callback OAuth URL: https://myhomeapp.com/oauth/v1/authorize

Note: The Redirect URL (or Callback URL) is the endpoint Beam will redirect the user after they authorize (or deny) your application.

Important: The OAuth redirect/callback URL must start with https://. Insecure URLs will not be accepted