Connecting to Dynamics 365 Business Central - Python Connector for Dynamics 365 Business Central

Connecting to Dynamics 365 Business Central

To establish a connection to Dynamics 365 Business Central, import the connector and use the connect() method with your connection parameters.

Step 1. Import the connector

First, import the Dynamics connector module:

import devart.dynamicsbc as dynamicsbc

Step 2. Establish a connection

Connect to your Dynamics 365 Business Central environment using the connect() module method and obtain a connection object.

You can connect to Dynamics 365 Business Central using either basic authentication or OAuth 2.0 authentication.

Basic authentication

For basic authentication, provide your Dynamics 365 Business Central server URL and authentication credentials:

my_connection = dynamicsbc.connect(
    Authentication="Basic",
    Server="your_dynamics365_url",
    UserId="your_username",
    AccessKey="your_access_key",
    CompanyId="your_company_id"
)

Replace the example values with your actual connection values.

For more information, see Connection parameters.

OAuth 2.0 authentication

For OAuth 2.0 authentication, first obtain a refresh token, then retrieve your environments and companies, and finally establish the connection:

response = dynamicsbc.signin()
my_environments = dynamicsbc.getenvironments(
    RefreshToken=response["Refresh Token"]
)
my_companies = dynamicsbc.getcompanies(
    RefreshToken=response["Refresh Token"],
    Environment=my_environments[0]
)
my_connection = dynamicsbc.connect(
    Authentication="OAuth",
    RefreshToken=response["Refresh Token"],
    Environment=my_environments[0],
    CompanyId=my_companies[0]["Company Id"]
)

Replace the example values with your actual connection values.

For more information, see Connection parameters.