API Usage Tutorial¶

In EspoCRM¶

Go to Administration > Roles and create a new role with permissions you want to grand for the API user.
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.

PHP¶

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

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

Javascript (Nodejs)¶

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

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 EspoCRM. See error codes.

Python¶

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

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)