πππππππππππππSet-Upππππππππππππππ
We have detailed video tutorials for each of the actions/elements we have in this plugin. Watch them to understand and use it at ease.
ππ You must set up your Microsoft Azure account and create a Microsoft Azure Project before you can use this plugin. Takes less than 5 mins if you follow the instructions. It is a one time process which is necessary to get your client-id and client-secret. ππ
β Go to
https://portal.azure.com/β Log in to your Microsoft account.
β Click on View button of "Manage Azure Active Directory" section.
β Click on App registrations on left-side of the dashboard.
β Click on "New registration".
β Fill all the details and register an app.
β Register redirect URL in the app.
β Create a client-secret and save it.
βΈ Step (1 to 8) is explained in detail:
βΈ Watch YouTube video here:
https://www.youtube.com/watch?v=ACXrdPANgE0ππππππππππInstalling the Pluginππππππππππ
β Log in to your Bubble account
β Go to Plugins
β Search for βOutlook E-Mail by Ritz7β
β Install the plugin
πππππππππππUsing the Pluginπππππππππππ
ππ Note: In all the actions, we have a field named "Authorization". This field should be in the following format: Bearer <Access-Token> or just <Access-Token>. Access Token will be valid for 60 mins from the time it is generated and you can regenerate it using the Refresh Token. And this step is explained in detail here:
https://www.youtube.com/watch?v=Ewggz0dVdzgππ
β Drag and drop the element "Outlook-Mail".
β Add an action called "Outlook Mail - Get Auth Code" which requires you to add Client-ID and redirect URL. This will return a URL that needs to be opened.
Note: The redirect URL should match exactly as you have set while configuring in Microsoft Azure project.
β Add Next step: You will have to open the URL you get from the previous step.
Note: This will ask your permission for your app to use your Outlook Account. Once you permit, the element will automatically fetch the code from the URL.
β Generate Auth Token via code: Call an Action "Get Access Token from Auth Code". This will require you to pass the client-ID, client-secret, code (you will get it from the element 'Outlook-Mail' and the param is named as 'outlook auth code') and redirect URL (this should match the one added in the Microsoft Azure Project)
Note: You will also get Refresh Token along with Access token from step-4. You use Refresh Token to get the Access Token once the old Access Token expires.
β Use "Get Access Token from Refresh Token" action to get the Access token from Refresh Token. This requires you to provide client-ID, client-secret and refresh token.
ππ Actions ππ
β½ Create a mail folder
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail Folder Name: Name of the mail folder which will be created.
β» isHidden: The folder will be hidden if its true or else false.
β Outputs:
β» Details of the mail folder.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=0JI-Bh_fjXIβ½ Update a mail folder
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response.
β» Mail Folder ID: ID of the mail folder which needs to be updated.
β» Mail Folder Name: Name of the mail folder which will be updated.
β Outputs:
β» Details of the updated mail folder.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=0JI-Bh_fjXIβ½ Get all mail folders
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response.
β» includeHiddenFolders: This must be true if you want to include hidden folders, otherwise false.
β» NoOfEmailFolders: Total count of mail folders you want to list at a time. You will receive a URL for the next set of folders.
β Outputs:
β» List of mail folders with their details.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=EqHnRg5nQGAβ½ Delete a mail folder
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail Folder ID: ID of the mail folder which needs to be updated.
β Outputs: None
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=5ZwdLvSYYWgβ½ Copy a mail folder
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail Folder ID: ID of the mail folder which needs to be updated.
β» destination-ID: ID of the destination where mail folder will be copied.
β Outputs:
β» Details of the copied mail folder.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=_Vkrd0z-0x8β½ Move a mail folder
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail Folder ID: ID of the mail folder which needs to be moved.
β» destination-ID: ID of the destination where mail folder will be moved.
β Outputs:
β» Details of the moved mail folder
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=_Vkrd0z-0x8β½ Create a child folder
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail Folder ID: ID of the mail folder where child folder will be created.
β» displayName: Name of the child folder which will be created.
β Outputs:
β» Details of the child folder created
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=Cn8_iUr8ycEβ½ Get all child folders
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail Folder ID: ID of the mail folder from where child folders will be retrieved.
β Outputs:
β» List of child folders with their details.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=EqHnRg5nQGAβ½ Update a child folder
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» childFolder-ID: ID of the child folder to be updated.
β» Name: Name of the child folder which will be updated.
β Outputs:
β» Details of the updated child folder
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=Cn8_iUr8ycEβ½ Delete a child folder
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» childFolder-ID: ID of the child folder to be deleted.
β Outputs: None
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=5ZwdLvSYYWgβ½ Get all mails from a folder
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» mailFolder-ID: ID of the mail folder from where all the mails will be retrieved.
β Outputs:
β» List of mails with their details.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=DNWo5Ly6Em8β½ Send email w/o attachments
β Inputs:
β» Access-Token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Subject: It is the subject of the mail.
β» Content-Type: Either write "Text" if you want your body to be in plain text or write "HTML" if you want your body in HTML format.
β» Content: It should contain the description of the mail.
β» To-Recipients: It should contain the recipient mail addresses for the mail.
β» CC-Recipients: It should contain the cc recipient mail addresses for the mail.
β» BCC-Recipients: It should contain the bcc recipient mail addresses for the mail.
β» Attachments: It should contain url of the attachments. If there are multiple attachments separate them by comma(,).
β Outputs:
β» Details of the email sent to the recipients
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=SjVbLN89tksβ½ Reply to an existing message
β Inputs:
β» Access-Token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response.
β» Mail Message ID: It is the id of the mail where reply will be sent.
β» Subject: It is the subject of the reply mail.
β» Content: It should contain the description of the mail.
β» To-Recipients: It should contain the recipient mail addresses for the reply mail.
β» CC-Recipients: It should contain the cc recipient mail addresses for the reply mail.
β» BCC-Recipients: It should contain the bcc recipient mail addresses for the reply mail.
β» Attachments: It should contain url of the attachments. If there are multiple attachments separate them by comma(,).
β Outputs:
β» Details of the reply mail sent to the parent mail.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=htdMxmUNGoQβ½ Reply-all to an existing message
β Inputs:
β» Access-Token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail-ID: It is the id of the mail where reply will be sent
β» Body: It should contain the description of the reply mail.
β Outputs: None
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=htdMxmUNGoQβ½ Forward an existing message
β Inputs:
β» Access-Token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail-ID: It is the id of the mail which will be forwarded.
β» Subject: It is the subject of the mail.
β» Content: It should contain the description of the mail.
β» To-Recipients: It should contain the recipient mail addresses for the mail.
β» CC-Recipients: It should contain the cc recipient mail addresses for the mail.
β» BCC-Recipients: It should contain the bcc recipient mail addresses for the mail.
β» Attachments: It should contain url of the attachments. If there are multiple attachments separate them by comma(,).
β Outputs:
β» Details of the email forwarded to the recipients
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=htdMxmUNGoQβ½ Copy a mail message
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail-ID: ID of the mail which needs to be copied.
β» destination-ID: ID of the destination folder where mail will be copied.
β Outputs: None
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=cMR3Js1zHUMβ½ Move a mail message
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail Folder ID: ID of the mail folder which needs to be moved.
β» destination-ID: ID of the destination folder where mail will be moved.
β Outputs: None
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=cMR3Js1zHUMβ½ Create a draft message
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Subject: It is the subject of the mail.
β» Content-Type: Either write "Text" if you want your body to be in plain text or write "HTML" if you want your body in HTML format.
β» Content: It should contain the description of the mail.
β» To-Recipients: It should contain the recipient mail addresses for the mail.
β» CC-Recipients: It should contain the cc recipient mail addresses for the mail.
β» BCC-Recipients: It should contain the bcc recipient mail addresses for the mail.
β» Attachments: It should contain url of the attachments. If there are multiple attachments separate them by comma(,).
β Outputs:
β» Details of the draft mail created.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=VLrXP3Fbk68β½ Create a draft message to reply
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail ID: ID of the mail where reply mail draft will be created.
β» Body: it should contain the body of the reply draft.
β Outputs:
β» Details of the mail with the reply draft.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=8sElMA8ZaoMβ½ Create a draft message to reply-all
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail ID: ID of the mail where reply-all mail draft will be created.
β» Body: it should contain the body of the reply-all draft.
β Outputs:
β» Details of the mail with the reply-all draft.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=8sElMA8ZaoMβ½ Create a draft message to forward
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail ID: ID of the mail which will be created as a draft to forward.
β Outputs:
β» Details of the mail draft which needs to be forwarded.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=8sElMA8ZaoMβ½ Update a draft message
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response.
β» Mail-ID: It is the id of the draft mail which will be updated.
β» Subject: It is the subject of the mail.
β» Content-Type: Either write "Text" if you want your body to be in plain text or write "HTML" if you want your body in HTML format.
β» Content: It should contain the description of the draft mail.
β» To-Recipients: It should contain the recipient mail addresses for the draft mail.
β» CC-Recipients: It should contain the cc recipient mail addresses for the draft mail.
β» BCC-Recipients: It should contain the bcc recipient mail addresses for the draft mail.
β» Attachments: It should contain url of the attachments. If there are multiple attachments separate them by comma(,).
β Outputs:
β» Details of the updated mail draft.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=UzjkdguX1qcβ½ Send a draft message
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail ID: ID of the draft mail which will be sent to the recipients.
β Outputs: None
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=VLrXP3Fbk68β½ Delete a Message
β Inputs:
β» Access token: It is received from "Get Access Token from Auth Code" or "Get Access Token from Refresh Token" API response
β» Mail ID: ID of the draft mail which will be deleted.
β Outputs:
β» Details of the mail with the reply-all draft.
βΈ Watch the video for the above action here:
https://www.youtube.com/watch?v=DNWo5Ly6Em8