Freee

Connecting to Freee

For an overview of the connector, please refer to the following link.

• Connecting to DB/SaaS

• Dashboard
• Local Version

1

Create a Connector

Select the “Connectors” tab on the top page and press the “Create” button.

2

Enter Freee Credentials

Select Freee and press the sign-in button.

After entering the information, press the Create button to complete the creation. If there are any errors in the parameters, an error message will be displayed, so please check the connection details again.

3

Retrieve access_token from the Created Connector

Once the creation is successful, you can retrieve the connector name from the list.

Use the dedicated function to enter the connector name in the Python code and retrieve the access_token.

Python

import morph
from morph import MorphGlobalContext
from morph_lib.api import get_auth_token


@morph.func
def main(context: MorphGlobalContext):
    access_token = get_auth_token("connection_name")
    # ↓↓↓ Process using access_token ↓↓↓

1

Create a Connector

Select the “Connectors” tab on the top page and press the “Create” button.

2

Enter Freee Credentials

Select Freee and press the sign-in button.

After entering the information, press the Create button to complete the creation. If there are any errors in the parameters, an error message will be displayed, so please check the connection details again.

3

Retrieve access_token from the Created Connector

Once the creation is successful, you can retrieve the connector name from the list.

Use the dedicated function to enter the connector name in the Python code and retrieve the access_token.

Python

import morph
from morph import MorphGlobalContext
from morph_lib.api import get_auth_token


@morph.func
def main(context: MorphGlobalContext):
    access_token = get_auth_token("connection_name")
    # ↓↓↓ Process using access_token ↓↓↓

In the local version, you currently need to directly write the credentials in ~/.morph/connections.yml. Please create the connector in the dashboard if you prefer other methods.

1

Edit connections.yml

If the file does not exist in ~/.morph/connections.yml, please create it beforehand and then edit it.

shell

mkdir ~/.morph
touch ~/.morph/connections.yml

connections:
  freee-connection: # Unique arbitrary name
    type: freee # Fixed
    method: freee_oauth # Fixed
    refresh_token: str
    client_id: str
    client_secret: str
    redirect_uri: str
    access_token: str # Optional

2

Use the Connector in Code to Retrieve Data

Use the dedicated function to enter the connector name in the Python code and retrieve the access_token.

Python

import morph
from morph import MorphGlobalContext
from morph_lib.api import get_auth_token


@morph.func
def main(context: MorphGlobalContext):
    access_token = get_auth_token("connection_name")
    # ↓↓↓ Process using access_token ↓↓↓

The refresh of the access_token is a dashboard feature, so the one specified in the local environment will always be used.

When actually specifying the connector and executing the file, the priority is as follows. Also, please note that only connectors created in the dashboard can be used in the environment where morph deploy is performed.

1. Connectors listed in ~/.morph/connections.yml on the local machine
2. Connectors registered in the cloud