Create an event

Adds a meeting to the calendar; it syncs to phone calendars when CalDAV is on.

POST/api/v1/events

Authorization

Authorizationheaderrequired

Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).

Module: CalendarScope: crm.write

Body application/json

titlestringrequired

Title.

startstringrequired

Start (YYYY-MM-DDTHH:MM).

endstringoptional

End.

all_daybooleanoptional

All day.

customer_idintegeroptional

Company.

customerstringoptional

Company name.

locationstringoptional

Location.

notestringoptional

Note.

Errors

HTTP	error	Meaning
`400`	`invalid`	Missing or invalid field (`message` explains).

Request

curl -X POST https://ornek.solk.app/api/v1/events \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Kuzey Plastik · hat denemesi",
  "start": "2026-10-07T10:00",
  "end": "2026-10-07T11:30",
  "customer_id": 31,
  "location": "Bursa OSB"
}'

const res = await fetch("https://ornek.solk.app/api/v1/events", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "title": "Kuzey Plastik · hat denemesi",
    "start": "2026-10-07T10:00",
    "end": "2026-10-07T11:30",
    "customer_id": 31,
    "location": "Bursa OSB"
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/events",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "title": "Kuzey Plastik · hat denemesi",
        "start": "2026-10-07T10:00",
        "end": "2026-10-07T11:30",
        "customer_id": 31,
        "location": "Bursa OSB"
    },
)
print(r.json())

Response

{
  "event": {
    "all_day": false,
    "customer": "Kuzey Plastik Sanayi",
    "customer_id": 31,
    "editable": true,
    "end": "2026-10-07T11:30:00",
    "id": 1,
    "join_url": "",
    "location": "Bursa OSB",
    "mode": "onsite",
    "note": "",
    "source": "manual",
    "start": "2026-10-07T10:00:00",
    "title": "Kuzey Plastik · hat denemesi"
  },
  "ok": true
}

Example responses were captured from a v22 installation running sample data; lists are shortened to two items.