Přejít na hlavní obsah
POST
/
contact-activity-logs
Vytvoriť CRM udalosť
curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/contact-activity-logs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "note",
  "metadata": {
    "content": "Follow-up call summary",
    "email": "crm@example.test",
    "personName": "John Caller",
    "phoneNumber": "+421900000000",
    "documentType": "invoice",
    "documentId": 301
  },
  "businessCaseId": 501,
  "clientId": 101,
  "supplierId": 151,
  "attachmentUploadTokens": [
    "eyJpdiI6Ik9wYXF1ZS1Ub2tlbi0xIn0=",
    "eyJpdiI6Ik9wYXF1ZS1Ub2tlbi0yIn0="
  ]
}
'
{
  "id": 551,
  "type": "note",
  "metadata": {
    "content": "Follow-up call summary",
    "email": "crm@example.test",
    "personName": "John Caller",
    "phoneNumber": "+421900000000",
    "documentNumberSnapshot": "20260001",
    "documentPriceSnapshot": 121,
    "documentCurrencySnapshot": {
      "id": 1,
      "symbol": "EUR",
      "name": "Euro",
      "mark": "€"
    },
    "paidAmount": 25.5,
    "relatedDocument": {
      "documentType": "invoice",
      "documentId": 301,
      "name": "Faktúra 20260001",
      "number": "20260001",
      "issueDate": "2026-03-10",
      "totalWithVat": 121,
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      }
    }
  },
  "attachments": [
    {
      "id": 9001,
      "name": "note.pdf",
      "mimeType": "application/pdf",
      "url": "https://cdn.fintoro.sk/contact-activity-attachments/note.pdf"
    }
  ],
  "businessCaseId": 501,
  "clientId": 101,
  "supplierId": 151,
  "createdAt": "2026-03-10T10:00:00+01:00",
  "updatedAt": "2026-03-10T10:30:00+01:00"
}

Autorizace

​
Authorization
string
header
povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Hlavičky

​
Idempotency-Key
string

Voliteľný identifikátor requestu pre bezpečné retry. Použite unikátnu hodnotu pre každé create volanie, ktoré chcete vedieť bezpečne zopakovať.

Příklad:

"invoice-create-2026-03-03-001"

Tělo

application/json

Payload pre vytvorenie CRM udalosti. Musíte poslať presne jedno z businessCaseId, clientId, supplierId, plus type a metadata. Voliteľné attachmentUploadTokens[] očakávajú tokeny z endpointu contact-activity-attachments. Pri document_linked type sa attachmenty nepodporujú.

​
type
enum<string>
povinné
Dostupné možnosti:
note,
email,
phone_call,
document_linked
Příklad:

"note"

​
metadata
object
povinné

Variabilný payload podľa type. Do requestu neposielajte snapshot polia ani relatedDocument; tie backend vypočíta alebo uloží sám.

​
businessCaseId
integer | null
Příklad:

501

​
clientId
integer | null
Příklad:

101

​
supplierId
integer | null
Příklad:

151

​
attachmentUploadTokens
string[]
Příklad:
[
  "eyJpdiI6Ik9wYXF1ZS1Ub2tlbi0xIn0=",
  "eyJpdiI6Ik9wYXF1ZS1Ub2tlbi0yIn0="
]

Odpověď

CRM udalosť bola vytvorená.

Unified CRM udalosť.

​
id
integer

Interné ID CRM udalosti.

Příklad:

551

​
type
enum<string>

Typ CRM udalosti.

Dostupné možnosti:
note,
email,
phone_call,
document_linked,
document_created,
document_updated,
document_deleted,
document_payment_added
Příklad:

"note"

​
metadata
object

Metadata CRM udalosti pripravené pre Fintoro API response.

​
attachments
object[]
​
businessCaseId
integer | null

ID obchodného prípadu, ak je aktivita naviazaná na obchodný prípad.

Příklad:

501

​
clientId
integer | null

ID klienta, ak je aktivita naviazaná priamo na klienta mimo obchodného prípadu.

Příklad:

101

​
supplierId
integer | null

ID dodávateľa, ak je aktivita naviazaná priamo na dodávateľa mimo obchodného prípadu.

Příklad:

151

​
createdAt
string<date-time> | null

Dátum a čas vytvorenia CRM udalosti.

Příklad:

"2026-03-10T10:00:00+01:00"

​
updatedAt
string<date-time> | null

Dátum a čas poslednej úpravy CRM udalosti.

Příklad:

"2026-03-10T10:30:00+01:00"