What is authorization?
If you use actions of any third-party services (Gmail, Dropbox, Evernote, etc.) in your workflow, Built.io Flow makes authorized calls to those services on your behalf. Therefore, you need to first authorize Built.io Flow to make these calls. Authorization is the process of granting Built.io Flow the permission to perform certain tasks in third-party apps or services on your behalf.
Creating an authorization
Let’s look at an example where we will create an authorization for Gmail. To do this, add ‘Gmail – Send an Email’ action to the canvas and configure it.
Under the ‘Authorize Gmail’ field, select ‘Add New’, by clicking on dropdown arrow, as shown in the following figure:
This will take you to ‘Gmail’ log-in page. To authenticate yourself as a user, you need to log in to 'Gmail' by entering your credentials.
The next page will ask you to authorize Built.io Flow to perform certain actions on your behalf. Select ‘ALLOW’ to proceed.
In case, if you have multiple gmail accounts, select any one of your choice to continue to Built.io Flow autorization. You'll get a screen requesting Built.io Flow wants to access your gmail account. Select 'ALLOW'.
Next you will see is a 'Add Authorization' window. Enter a name for the authorization you are about to create in the ‘Auth Label’ field. This could be any name of your choice (E.g., Test). After entering a name, click the 'ADD' button.
Once you do this, you will see a new entry (‘Test’) under 'Authorizations'.
That’s it! You have successfully created an authorization for Gmail. Now you can use the ‘Gmail – Send an Email’ action in your workflow.
Common authorization for a single service
It is important to remember that, once you create an authorization (let’s say for Gmail), you can use the same authorization for other Gmail actions such as ‘Get Mail Details’ and ‘Get Mail Attachment’. You need not create a new authorization for different action of the same service.
It is important to note that all the authorizations created in Built.io Flow, have a global scope. Meaning, an authorization created in one workflow, can be used in all the other workflows of your account.
All the authorizations of all the workflows of a project folder can be viewed, updated, and deleted through 'CONFIGURATION > AUTHORIZATION' tab. All authorizations of a particular workflow can be viewed in the 'Workflow Settings' page.
No limit to number of authorizations created
There is no limit to the number of authorizations you can create for a service.