CreateNewContact

Function to create a new contact

POST https://rest.crmango.com/api/CreateNewContact

Authorization1 Body data40 Response3 Example request

Authorization

1 Sent in the request headers

Bearer varchar

Auth token

Body data

40 Sent in the request body

owner integer

Company owner
Reference: GetAllUsers

is_company boolean

0 - self-employed, 1 - company

title varchar

Company name

company_id_number integer

Company id number (numbers only)

vat_number varchar

Company vat number

vat varchar

Company vat

firstname varchar

Firstname

lastname varchar

Lastname

birth_number varchar

Birth number

address varchar

Address

city varchar

City

postcode integer

Postcode

district varchar

District

region varchar

Region

state varchar

State id or ISO2 code (e.g. SK). Unknown code = 202
Reference: GetAllStates

latitude float

Latitude

longitude float

Longitude

disabled boolean

0 - active, 1 - disabled

user integer

User id (salesman)
Reference: GetAllUsers

next_activity timestamp

Date of next activity

status_id integer

Status id
Reference: GetAllLists

typk_id integer

Contact type id. User must have the right to see this type
Reference: GetAllLists

aktivnep_id varchar

Active items id, e.g. ,2,4,7,
Reference: GetAllLists

score integer

Score 0 - 5

invoice_days integer

Invoice due days

invoice_type integer

Invoice type

invoice_note varchar

Invoice note

credit_limit float

Credit limit

company_currency varchar

Currency id or code (e.g. EUR). Unknown code = 202

invoice_email varchar

E-mail for invoices

mailing_name varchar

Mailing address - name

mailing_address varchar

Mailing address - street

mailing_city varchar

Mailing address - city

mailing_postal integer

Mailing address - postcode

mailing_state varchar

Mailing address - state id or ISO2 code
Reference: GetAllStates

internal_note varchar

Internal note (stored encrypted)

general_discount float

General discount in percent

bank_data json

Array of bank accounts: bank_iban, bank_note, swift_bic, bank_account, bank_connection

own_cols[id_own_col] integer

Own col input id
Reference: GetContactOwnCols

own_cols[data] varchar

Input data

Response

3 HTTP 201

Function to create a new contact

code integer

Return code

message varchar

Info message

created_id integer

Id of the created resource

Example request

curl --request POST \
  --url 'https://rest.crmango.com/api/CreateNewContact' \
  --header 'Authorization: Bearer auth_token' \
  --header 'Content-Type: application/json' \
  --data '{
    {
      "data": {
        "is_company": 1,
        "title": "CRMango Slovakia",
        "company_id_number": "12345678",
        "vat_number": "SK1234567890",
        "vat": "SK1234567890",
        "firstname": "John",
        "lastname": "Doe",
        "birth_number": "0101011234",
        "address": "Hlavná 123",
        "city": "Bratislava",
        "postcode": 81101,
        "district": "Bratislava I",
        "region": "Bratislavský",
        "state": "SK",
        "latitude": 48.1486,
        "longitude": 17.1077,
        "disabled": 0,
        "user": 12,
        "owner": 5,
        "next_activity": 22,
        "status_id": 1,
        "typk_id": 3,
        "aktivnep_id": ",2,4,7,",
        "score": 2,
        "invoice_days": 14,
        "invoice_type": 1,
        "invoice_note": "Payment in advance",
        "credit_limit": 5000,
        "company_currency": "EUR",
        "invoice_email": "billing@crmango.sk",
        "mailing_address": "Poštová 5",
        "mailing_city": "Košice",
        "mailing_postal": 04001,
        "mailing_state": "SK",
        "internal_note": "VIP client",
        "general_discount": 10,
        "mailing_name": "Billing Department",
        "bank_data": [
          {
            "bank_iban": "SK6802000000001234567890",
            "bank_note": "Main account",
            "swift_bic": "SUBASKBX",
            "bank_account": "1234567890/0200",
            "bank_connection": "VUB"
          }
        ],
        "own_cols": [
          {
            "id_own_col": 1,
            "data": "Custom value"
          },
          {
            "id_own_col": 3,
            "data": "2025-04-25"
          }
        ]
      }
    }
  }'

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://rest.crmango.com/api/CreateNewContact',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    {
      "data": {
        "is_company": 1,
        "title": "CRMango Slovakia",
        "company_id_number": "12345678",
        "vat_number": "SK1234567890",
        "vat": "SK1234567890",
        "firstname": "John",
        "lastname": "Doe",
        "birth_number": "0101011234",
        "address": "Hlavná 123",
        "city": "Bratislava",
        "postcode": 81101,
        "district": "Bratislava I",
        "region": "Bratislavský",
        "state": "SK",
        "latitude": 48.1486,
        "longitude": 17.1077,
        "disabled": 0,
        "user": 12,
        "owner": 5,
        "next_activity": 22,
        "status_id": 1,
        "typk_id": 3,
        "aktivnep_id": ",2,4,7,",
        "score": 2,
        "invoice_days": 14,
        "invoice_type": 1,
        "invoice_note": "Payment in advance",
        "credit_limit": 5000,
        "company_currency": "EUR",
        "invoice_email": "billing@crmango.sk",
        "mailing_address": "Poštová 5",
        "mailing_city": "Košice",
        "mailing_postal": 04001,
        "mailing_state": "SK",
        "internal_note": "VIP client",
        "general_discount": 10,
        "mailing_name": "Billing Department",
        "bank_data": [
          {
            "bank_iban": "SK6802000000001234567890",
            "bank_note": "Main account",
            "swift_bic": "SUBASKBX",
            "bank_account": "1234567890/0200",
            "bank_connection": "VUB"
          }
        ],
        "own_cols": [
          {
            "id_own_col": 1,
            "data": "Custom value"
          },
          {
            "id_own_col": 3,
            "data": "2025-04-25"
          }
        ]
      }
    }
  }',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer auth_token',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

echo $response;

var data = JSON.stringify({
  {
    "data": {
      "is_company": 1,
      "title": "CRMango Slovakia",
      "company_id_number": "12345678",
      "vat_number": "SK1234567890",
      "vat": "SK1234567890",
      "firstname": "John",
      "lastname": "Doe",
      "birth_number": "0101011234",
      "address": "Hlavná 123",
      "city": "Bratislava",
      "postcode": 81101,
      "district": "Bratislava I",
      "region": "Bratislavský",
      "state": "SK",
      "latitude": 48.1486,
      "longitude": 17.1077,
      "disabled": 0,
      "user": 12,
      "owner": 5,
      "next_activity": 22,
      "status_id": 1,
      "typk_id": 3,
      "aktivnep_id": ",2,4,7,",
      "score": 2,
      "invoice_days": 14,
      "invoice_type": 1,
      "invoice_note": "Payment in advance",
      "credit_limit": 5000,
      "company_currency": "EUR",
      "invoice_email": "billing@crmango.sk",
      "mailing_address": "Poštová 5",
      "mailing_city": "Košice",
      "mailing_postal": 04001,
      "mailing_state": "SK",
      "internal_note": "VIP client",
      "general_discount": 10,
      "mailing_name": "Billing Department",
      "bank_data": [
        {
          "bank_iban": "SK6802000000001234567890",
          "bank_note": "Main account",
          "swift_bic": "SUBASKBX",
          "bank_account": "1234567890/0200",
          "bank_connection": "VUB"
        }
      ],
      "own_cols": [
        {
          "id_own_col": 1,
          "data": "Custom value"
        },
        {
          "id_own_col": 3,
          "data": "2025-04-25"
        }
      ]
    }
  }
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://rest.crmango.com/api/CreateNewContact");
xhr.setRequestHeader("Authorization", "Bearer auth_token");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);

import requests
import json

url = "https://rest.crmango.com/api/CreateNewContact"

payload = json.dumps({
  {
    "data": {
      "is_company": 1,
      "title": "CRMango Slovakia",
      "company_id_number": "12345678",
      "vat_number": "SK1234567890",
      "vat": "SK1234567890",
      "firstname": "John",
      "lastname": "Doe",
      "birth_number": "0101011234",
      "address": "Hlavná 123",
      "city": "Bratislava",
      "postcode": 81101,
      "district": "Bratislava I",
      "region": "Bratislavský",
      "state": "SK",
      "latitude": 48.1486,
      "longitude": 17.1077,
      "disabled": 0,
      "user": 12,
      "owner": 5,
      "next_activity": 22,
      "status_id": 1,
      "typk_id": 3,
      "aktivnep_id": ",2,4,7,",
      "score": 2,
      "invoice_days": 14,
      "invoice_type": 1,
      "invoice_note": "Payment in advance",
      "credit_limit": 5000,
      "company_currency": "EUR",
      "invoice_email": "billing@crmango.sk",
      "mailing_address": "Poštová 5",
      "mailing_city": "Košice",
      "mailing_postal": 04001,
      "mailing_state": "SK",
      "internal_note": "VIP client",
      "general_discount": 10,
      "mailing_name": "Billing Department",
      "bank_data": [
        {
          "bank_iban": "SK6802000000001234567890",
          "bank_note": "Main account",
          "swift_bic": "SUBASKBX",
          "bank_account": "1234567890/0200",
          "bank_connection": "VUB"
        }
      ],
      "own_cols": [
        {
          "id_own_col": 1,
          "data": "Custom value"
        },
        {
          "id_own_col": 3,
          "data": "2025-04-25"
        }
      ]
    }
  }
})
headers = {
  'Authorization': 'Bearer auth_token',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

{
    "code": 201,
    "message": "New contact has been added",
    "created_id": 254
}

{
    "code": "int",
    "message": "string"
}