Activities

I'm here (check in)

Records arrival at a company with a location. If the company's location is known the distance and status (ok · far · low) are calculated; if not and the accuracy is better than ±250 m this point becomes the company location (set). The previous open check-in becomes left. When the visit is saved with Quick Entry the check-in is attached to it and the duration is calculated. Response: checkin, message. 400 off when the setting is off, 400 no_geo without a location.

POST/api/v1/visits/checkin

Authorization

Authorizationheaderrequired

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

Module: Visits / ActivitiesScope: crm.write

Body application/json

customer_idintegeroptional

Company id (or customer name).

customerstringoptional

Company name (when no id).

geo_lat / geo_lng / geo_accnumberrequired

Latitude, longitude, accuracy (m) — or geo: {lat, lng, acc}.

Errors

HTTP	error	Meaning
`400`	`invalid`	Missing or invalid field (`message` explains).
`404`	`not_found`	Record not found.

Request

curl -X POST https://ornek.solk.app/api/v1/visits/checkin \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/visits/checkin", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/visits/checkin",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Response