Activities
Log an activity
Quick Entry: logs a phone call or face-to-face visit in one request. The company is matched by name (created as a prospect when missing; similar names return 409 similar), a missing person is added, matching open actions are closed, the next action is opened and the project advances under the same rules as the web form. parts tells what was recorded; warnings and advice explain what needs attention.
Authorization
AuthorizationheaderrequiredBearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).
Module: Visits / ActivitiesScope:
crm.writeBody application/json
customerstringrequiredCompany name (exact or close).
visit_typestringoptionalF2F face to face, Online online meeting (v43b), Call phone, Deneme trial visit.Values
F2FOnlineCallDenemevisit_datestringoptionalActivity date (YYYY-MM-DD, default today).
contactstringoptionalPerson met (added when missing).
contact_title / contact_phone / contact_emailstringoptionalDetails for a new person.
topicstringoptionalTopic — free text, up to 40 characters (suggestions:
/qe/config → topics).notestringoptionalWhat was discussed.
resultstringoptionalOutcome.
next_actionstringoptionalNext action.
action_datestringoptionalNext action date.
opp_idintegeroptionalProject to log against.
product / competitor / offer_price / payment_days / potential_kgmixedoptionalProject details (same as the web form).
order_kg / order_kindmixedoptionalOrder quantity (in the product's unit) and kind (
İlk Sipariş, Yeni Sipariş); opens an order when set.customer_postringoptionalThe customer's purchase order number (PO) — written to the new order and sent to the ERP with it (v55; up to 60 characters).
confirm_newbooleanoptionalCreate a new company even if similar names exist.
geo_lat / geo_lng / geo_accnumberoptionalv66: visit location (exit) — latitude, longitude, accuracy (m). Only handled for
F2F / Deneme dated today; with an open check-in the arrival comes from it and the duration is calculated. geo: {lat, lng, acc} works too.geo_notestringoptionalv66: the reason no location was left (
denied, nosignal, elsewhere, other or free text) — required for a visit without a location in required mode.Values
deniednosignalelsewhereotherErrors
| HTTP | error | Meaning |
|---|---|---|
400 | invalid | Missing or invalid field (`message` explains). |
400 | geo_required | v66: a face-to-face visit must have a location — send `geo_lat` / `geo_lng` or `geo_note` (a reason); `reasons` lists the options. |
409 | similar | Similar names exist (`similar`); send `confirm_new: true` to create anyway. |
Request
curl -X POST https://ornek.solk.app/api/v1/quick \
-H "Authorization: Bearer $SOLK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer": "Kuzey Plastik Sanayi",
"visit_type": "Call",
"contact": "Emre Yıldız",
"note": "Deneme sonuçlarını konuştuk; kalınlık 23 mikron uygun.",
"result": "Olumlu",
"next_action": "Teklif gönder",
"action_date": "2026-10-18"
}'const res = await fetch("https://ornek.solk.app/api/v1/quick", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"customer": "Kuzey Plastik Sanayi",
"visit_type": "Call",
"contact": "Emre Yıldız",
"note": "Deneme sonuçlarını konuştuk; kalınlık 23 mikron uygun.",
"result": "Olumlu",
"next_action": "Teklif gönder",
"action_date": "2026-10-18"
}),
});
const data = await res.json();import os, requests
r = requests.post(
"https://ornek.solk.app/api/v1/quick",
headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
json={
"customer": "Kuzey Plastik Sanayi",
"visit_type": "Call",
"contact": "Emre Yıldız",
"note": "Deneme sonuçlarını konuştuk; kalınlık 23 mikron uygun.",
"result": "Olumlu",
"next_action": "Teklif gönder",
"action_date": "2026-10-18"
},
)
print(r.json())Response
{
"advice": null,
"closed": [],
"created": false,
"customer": {
"active": true,
"at_risk": false,
"city": "Bursa",
"currency": "EUR",
"currency_default": "",
"id": 31,
"initials": "KP",
"last_visit": "2026-10-15",
"main_contact": {
"email": "emre.yildiz@kuzeyplastik.com.tr",
"name": "Emre Yıldız",
"phone": "+90 532 555 11 22",
"wa": "905325551122"
},
"name": "Kuzey Plastik Sanayi",
"next_visit_due": "2026-11-14",
"open_opps": 1,
"owner": {
"color": "#5867e8",
"full_name": "Deniz Aksoy",
"id": 1,
"photo": null,
"role": "admin",
"role_label": "Yönetici",
"username": "admin"
},
"pending_state": "soon",
"period": 30,
"phone": "+90 224 555 01 02",
"potential_kg": null,
"rid": "0017AMMvazTfMd5",
"sector": "Plastik",
"status": "AC",
"status_label": "Aktif Müşteri",
"unit": "kg",
"visit_overdue_days": -30,
"visit_state": "ok"
},
"message": "Kuzey Plastik Sanayi kaydedildi: ziyaret, proje #53 Streç film tedariki.",
"next_step": "F2F ziyaret planla ve gerçekleştir",
"ok": true,
"opp": {
"bant": 4,
"base_currency": "EUR",
"close_date": "2026-11-29",
"cur_sym": "€",
"currency": "EUR",
"customer": "Kuzey Plastik Sanayi",
"customer_city": "Bursa",
"customer_id": 31,
"days_in_stage": 0,
"detail_status": "",
"fc": "Best Case",
"health": {
"grade": "success",
"label": "sağlıklı",
"score": 95
},
"health_color": "g",
"health_manual": false,
"health_note": "",
"id": 53,
"initials": "KP",
"is_account": false,
"is_open": true,
"last_update": "2026-10-15",
"lifetime_left": 180,
"line": "",
"name": "Streç film tedariki",
"next_step": "F2F ziyaret planla ve gerçekleştir",
"offer_price": 2.35,
"owner": {
"color": "#5867e8",
"full_name": "Deniz Aksoy",
"id": 1,
"photo": null,
"role": "admin",
"role_label": "Yönetici",
"username": "admin"
},
"payment_days": 60,
"potential_kg": 12000.0,
"prob": 0.25,
"probability": null,
"product": "",
"product_id": null,
"pu": "€/kg",
"rid": "006mdby8Icru9GV",
"sla_days": 60,
"sla_left": 60,
"source": "",
"stage": "Viable",
"stage_label": "Viable",
"start_date": "2026-10-15",
"trend": "",
"trend_label": "Otomatik",
"type": "",
"unit": "kg",
"unit_code": "kg",
"value": 338400.0,
"value_base": 338400.0,
"value_short": "338K"
},
"opp_new": false,
"parts": [
"ziyaret",
"proje #53 Streç film tedariki"
],
"visit": {
"action_date": "2026-10-18",
"action_done": false,
"action_state": "soon",
"contact": "Emre Yıldız",
"customer": "Kuzey Plastik Sanayi",
"customer_id": 31,
"date": "2026-10-15",
"id": 106,
"line": "",
"next_action": "Teklif gönder",
"note": "Deneme sonuçlarını konuştuk; kalınlık 23 mikron uygun.",
"opp": "Streç film tedariki",
"opp_id": 53,
"product": "",
"result": "Olumlu",
"rid": "00UD3EWzPIzHikj",
"topic": "Görüşme",
"type": "Call",
"user": "Deniz Aksoy"
},
"warnings": []
}Example responses were captured from a v98 installation running sample data; lists are shortened to two items.