Documentation

Application Reference

In this article

Sam van de Kreeke

Published:

Last updated: 12-02-2020

Applications

Let’s create a new Application. Click `Create application` in the top right corner of the Application. This will open a modal where you’ll have to select the Organization to create the new Application on, fill in the name of the Application, and the identifier.

Organization: This is a dropdown with all the Organizations. Choose an Organization to create the new Application in.
(When creating an Application from an Organization, this option isn’t shown)
Name: Choose a name for your Application.
Identifier: The Identifier of an Application is the unique part of an Application’s URL, used to reach your Application. For example, if the Identifier of an Application is `task-manager`, the URL would be: `https://task-manager.bettyblocks.com`.


Application

When the Application has been created, you’ll see 3 options:

  • Application settings
  • User management
  • Delete application


  

Application settings


In the Application settings, there are a lot of different options:

  • Options
  • Web options
  • Hostnames
  • SMTP
  • Invitation


Options

Icon: Choose an icon for your Application. The icon is only visible within My Betty Blocks and the login page.
Background: Choose a background for your Application. Just like the icon, the background is only visible within My Betty Blocks and the login page. 
Name: Choose a name for your Application.
Identifier: The Identifier of an Application is the unique part of an Application’s URL, used to reach your Application. For example, if the Identifier of an Application is `task-manager`, the URL would be: `https://task-manager.bettyblocks.com`.
Organization: Choose which Organization you would like the Application to be in.
Logging: When the logging option is enabled, you are able to log actions and endpoints within your Application. This function overrules all the logging options inside of the Application. For example, if this option is disabled, none of the logging options will work in the Application.
Mandril API key: Fill in the Mandrill API key to use your own Mandrill service. 
Usabilla script identifier: Fill in the Usabilla script identifier to enable Usabilla functionalities on your endpoints.


Web options

Maintenance mode: Turn on to enable maintenance mode, this will temporarily disable your Application until you turn the option off.
Cross-origin resource sharing protection: Turn on to enable cross-origin resource sharing protection. 
Allow in iframe: Allow your Application to be embedded in iframes from external applications, deny your Application to be embedded in iframes from external applications, or allow your Application to be embedded in iframes from only the same Application.
Content security policy: Specify the content of your content security policy headers.
Custom 404 page: Select an existing template to render when a user encounters a 404 error.
Custom 500 page: Select an existing template to render when a user encounters a 500 error.
Custom page for maintenance mode: Select a custom page from your Application to render when maintenance mode is enabled.


Hostnames

Add a hostname: Fill in your own domain, your Application can be accessed from the added hostnames.
A hostname can be deleted and verified by clicking on either one of the buttons on the right of the added hostname. For more information about verifying your domain, click and expand `HOW TO VERIFY YOUR DOMAIN` at the bottom of the page.


SMTP

SMTP enabled: Toggle on to enable the SMTP settings.
Address: Fill in the address you want the emails to be sent from.
Port: Fill in the port of your domain.
Domain: Fill in the domain of your SMTP server.
Username: Fill in the username to login with into your SMTP server.
Password: Fill in the password to login with into your SMTP server.
Authentication: Choose what kind of authentication you want to use for the SMTP settings.
Start TLS: Toggle on to enable StartTLS for your SMTP server.


Invitation

Invitation reply to: Choose an email address where the invitation should be sent from.
Invitation subject: Choose a subject what the invitation is about.
Invitation text: Write a message that invited users will receive inside of their mailbox.
The invitation settings can be saved or reset to default by clicking either one of the buttons at the bottom of the page.


User management

In the User management option, you can invite and delete users to or from your Application.

To invite a new user to your Application, click `Invite members` in the top right corner of the application. You can invite multiple users at once by filling in the email address and pressing enter to start with the next one. When you’ve entered all the users that you want to send an invite to, you can click `Send invite` in the bottom right corner of the modal. An Application user can be a `User` or a `Builder`, and can also be an API user by enabling the API toggle button. If you want to know more about the Betty Blocks REST API and API users, feel free to check out our article about it: Betty Blocks REST API. Application users can also be removed from your Application by clicking the bin icon on the right of an Application user.


Delete application

To delete your Application you can click `Delete application` which is the third option of the 3 options to the right of the Application info. A modal will pop up and you'll have to enter "delete" followed by your Application name.


In this article