Skip to main content
POST
/
contact-activity-logs
Create a CRM event
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": "Invoice 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"
}

Authorizations

​
Authorization
string
header
required

Bearer token created for a specific company in Integrations → API.

Headers

​
Idempotency-Key
string

Optional request identifier for safe retries. Use a unique value for each create request you want to retry safely.

Example:

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

Body

application/json

Payload for creating a CRM event. You must send exactly one of businessCaseId, clientId, or supplierId, together with type and metadata. Optional attachmentUploadTokens[] expect values returned by the contact-activity-attachments endpoint. Attachments are not supported for the document_linked type.

​
type
enum<string>
required
Available options:
note,
email,
phone_call,
document_linked
Example:

"note"

​
metadata
object
required

Type-dependent payload. Do not send snapshot fields or relatedDocument; those are computed or persisted by the backend.

​
businessCaseId
integer | null
Example:

501

​
clientId
integer | null
Example:

101

​
supplierId
integer | null
Example:

151

​
attachmentUploadTokens
string[]
Example:
[
  "eyJpdiI6Ik9wYXF1ZS1Ub2tlbi0xIn0=",
  "eyJpdiI6Ik9wYXF1ZS1Ub2tlbi0yIn0="
]

Response

CRM event created.

Unified CRM event.

​
id
integer

Internal CRM event ID.

Example:

551

​
type
enum<string>

CRM event type.

Available options:
note,
email,
phone_call,
document_linked,
document_created,
document_updated,
document_deleted,
document_payment_added
Example:

"note"

​
metadata
object

CRM event metadata prepared for the Fintoro API response.

​
attachments
object[]
​
businessCaseId
integer | null

Business case ID when the activity is linked to a business case.

Example:

501

​
clientId
integer | null

Client ID when the activity is linked directly to a client outside a business case.

Example:

101

​
supplierId
integer | null

Supplier ID when the activity is linked directly to a supplier outside a business case.

Example:

151

​
createdAt
string<date-time> | null

CRM event creation timestamp.

Example:

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

​
updatedAt
string<date-time> | null

CRM event last update timestamp.

Example:

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