API Usage Tutorial

In AICRM

1. Go to Administration > Roles and create a new role with permissions you want to grand for the API user.
2. Go to Administration > API Users and create a new API User. Select the created role. An API Key will be generated, you will need to use it in your API requests further.

In external application

• PHP
• Javascript (Nodejs)
• Python

PHP

Install PHP API client via composer. See usage examples in the same article.

If something went wrong, check data/logs in your AICRM. See error codes.

Javascript (Nodejs)

1. Create a new JS file: espocrm-api-client.js with the code copied from here.
2. Use require function to include the module in the place where you want to call AICRM API and use it. See the code below.

```js const Client = require('./espocrm-api-client');

const client = new Client( 'https://address-of-your-espocrm', 'copy API key from API user to here' );

// POST request example const payload = { name: 'some name', type: 'Customer', };

client .request('POST', 'Account', payload) .then( (response) => { // success console.log(response); } ) .catch( (res) => { // error console.log(res.statusCode, res.statusMessage); } ); ```

If something went wrong, check data/logs in your AICRM. See error codes.

Python

1. Create a new file: espocrm-api-client.py with the code copied from here.
2. Install requests package with the command: pip install requests.
3. Use the client. See the code:

```python from espo_api_client import EspoAPI

client = EspoAPI('https://address-of-your-espocrm', 'paste_api_key_here')

params = { "select": "id,phoneNumber", "where": [ { "type": "equals", "attribute": "emailAddress", "value": 'some@email.com', }, ], }

result = client.request('GET', 'Lead', params) ```