Create a mesa - FinSync Docs

Create a mesa

curl --request POST \
  --url https://api.finsync.ar/api/mesas \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "ARS/USD desk",
  "local_currency": "ARS",
  "quote_currency": "USD",
  "costing_method": "fifo",
  "account_ids": [
    10,
    11
  ]
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'ARS/USD desk',
    local_currency: 'ARS',
    quote_currency: 'USD',
    costing_method: 'fifo',
    account_ids: [10, 11]
  })
};

fetch('https://api.finsync.ar/api/mesas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'ARS/USD desk',
    local_currency: 'ARS',
    quote_currency: 'USD',
    costing_method: 'fifo',
    account_ids: [10, 11]
  })
};

fetch('https://api.finsync.ar/api/mesas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.finsync.ar/api/mesas"

payload = {
    "name": "ARS/USD desk",
    "local_currency": "ARS",
    "quote_currency": "USD",
    "costing_method": "fifo",
    "account_ids": [10, 11]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": 1,
  "company_id": 42,
  "name": "ARS/USD desk",
  "local_currency": "ARS",
  "quote_currency": "USD",
  "costing_method": "fifo",
  "account_ids": [
    10,
    11
  ],
  "created_by": null,
  "created_at": "2026-03-01T00:00:00.000Z",
  "updated_at": "2026-03-01T00:00:00.000Z",
  "deleted_at": null
}

{
  "error": "Mesas module not enabled for this company",
  "code": "MESAS_DISABLED"
}

POST

/

api

/

mesas

Create a mesa

curl --request POST \
  --url https://api.finsync.ar/api/mesas \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "ARS/USD desk",
  "local_currency": "ARS",
  "quote_currency": "USD",
  "costing_method": "fifo",
  "account_ids": [
    10,
    11
  ]
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'ARS/USD desk',
    local_currency: 'ARS',
    quote_currency: 'USD',
    costing_method: 'fifo',
    account_ids: [10, 11]
  })
};

fetch('https://api.finsync.ar/api/mesas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'ARS/USD desk',
    local_currency: 'ARS',
    quote_currency: 'USD',
    costing_method: 'fifo',
    account_ids: [10, 11]
  })
};

fetch('https://api.finsync.ar/api/mesas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.finsync.ar/api/mesas"

payload = {
    "name": "ARS/USD desk",
    "local_currency": "ARS",
    "quote_currency": "USD",
    "costing_method": "fifo",
    "account_ids": [10, 11]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": 1,
  "company_id": 42,
  "name": "ARS/USD desk",
  "local_currency": "ARS",
  "quote_currency": "USD",
  "costing_method": "fifo",
  "account_ids": [
    10,
    11
  ],
  "created_by": null,
  "created_at": "2026-03-01T00:00:00.000Z",
  "updated_at": "2026-03-01T00:00:00.000Z",
  "deleted_at": null
}

{
  "error": "Mesas module not enabled for this company",
  "code": "MESAS_DISABLED"
}

Authorizations

x-api-key

string

header

required

API Key for authentication

Body

application/json

name

string

required

Example:

"ARS/USD desk"

local_currency

string

required

Example:

"ARS"

quote_currency

string

required

Example:

"USD"

costing_method

enum<string>

required

Available options:

fifo,

wac

Example:

"fifo"

account_ids

integer[]

required

Minimum array length: 1

Example:

[10, 11]

include_pending

boolean

Defaults to false (completed-only).

Example:

false

Response

Mesa created

FX trading desk. created_by is null for x-api-key creates. account_ids are internal (Client.type=0) accounts unique to one mesa.

id

integer

Example:

1

company_id

integer

Example:

42

name

string

Example:

"ARS/USD desk"

local_currency

string

Example:

"ARS"

quote_currency

string

Example:

"USD"

costing_method

enum<string>

Available options:

fifo,

wac

Example:

"wac"

perspective

enum<string>

quote: Compra = quote in = engine sell. New desks default to quote.

Available options:

local,

quote

Example:

"quote"

feed_mode

enum<string>

manual: blotter starts empty (user confirms lines). auto: apply high-confidence Sugerir matches (exact / fx_close) as blotter lines; links never write operations. New desks default to manual.

Available options:

auto,

manual

Example:

"manual"

include_pending

boolean

Off (default): Sugerir / auto-feed / infer only count completed legs. On: pending legs count too. Cancel drops the blotter line; approve keeps the same link.

Example:

false

account_ids

integer[]

Example:

[10, 11]

created_by

integer | null

Example:

null

created_at

string<date-time>

updated_at

string<date-time>

deleted_at

string<date-time> | null