🆕How to create clients

Client Creation and Authentication in the OctoTable API

The OctoTable API allows users to create a client to begin integrating with our reservation system. ⚠️ To use the OctoTable APIs correctly, you need to download Postman and avoid using the desktop version. To initiate this process, a minimum set of attributes is required:

• Name: The name of the property.

• Email: The email associated with the property.

• Username: The username associated with user of the the property.

• Password: The password of the user.

• Redirect Uri: The redirect uri of the company's web page

Once the Create Client call is made, the system generates a Client ID and Client Secret, which are crucial for the next step in the integration.

Generating an Access Token

Using the provided Client ID and Client Secret, you can perform the Create Access Token call. This token serves as the key to accessing the full functionality of the API.

Testing Environment

When a client is created, OctoTable automatically sets up a fake property for testing purposes. This allows you to experiment with and test the API's features before using it in a live environment.

With the access token, you can proceed to execute all other operations available in the OctoTable API NOTE The testing environment is available for a limited period, ensuring you have ample time to explore and familiarize yourself with the API's functionalities before transitioning to production.

⚙️ Use the base resource URL for the following examples, or see complete collection

https://api.octorate.com/octotable-pms/api/v2

🆕 Create a new client

POST /api-account/oauth2/client

Creates a new oauth2 client

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
name	string	Name of the sandbox property
email	string	Email of the property
username	string	Username
password	string	Password
redirect_uri	string	The redirect uri of the company

Response

200 OK

{
    "data": [
        {
            "client_id": "public_8956990355e6df036-b5ff-48cd-b8be-b3d93fb752",
            "client_secret": "12404a0a-9cbf-4b40-82cc-32296e92c515",
            "id": 124,
            "username": "[e-mail]",
            "password": "yourCompany123!",
            "properties": [
                {
                    "enabled": true,
                    "id": 999641,
                    "name": "Your Company SPA",
                    "position": {},
                    "sandbox": true
                }
            ],
            "redirect_uri": "http://your-webdite:80/main-page"
        }
    ]
}