ComRaidComRaid Docs
API referenceMobile

Record an SDK session and refresh Properties

Increments Subscription `session_count`, advances `last_seen_at` / Contact `last_active_at`, and upserts first-class Properties (timezone, locale, language, country, app/OS versions). Distinct from customer Attributes. Requires a matching subscription_credential (credential-less Endpoints return 401). Inactive Subscriptions return 409 (`subscription_inactive`).

POST
/mobile/subscriptions/{id}/session

Increments Subscription session_count, advances last_seen_at / Contact last_active_at, and upserts first-class Properties (timezone, locale, language, country, app/OS versions). Distinct from customer Attributes. Requires a matching subscription_credential (credential-less Endpoints return 401). Inactive Subscriptions return 409 (subscription_inactive).

Authorization

mobileAppId
headerX-ComRaid-App-Id<token>

Publishable mobile app id (cr_app_...)

Path Parameters

id*string
Formatuuid

Request Body

application/json
  1. body
subscription_credential*string
app_version?string
sdk_version?string
locale?string
timezone?string
language?string
country?string
device?

Response Body

Session recorded

application/json
  1. response
subscription_id*string
Formatuuid
session_count*integer
Range1 <= value
last_seen_at*string
Formatdate-time
Example Request
curl -X POST 'https://api.comraid.io/mobile/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/session' \  -H 'Content-Type: application/json' \  -d '{  "subscription_credential": "high-entropy-secret",  "app_version": "2.0.0",  "locale": "en-US",  "timezone": "America/New_York",  "language": "en",  "country": "US",  "device": {    "os": "Android",    "os_version": "14",    "model": "Pixel 8"  }}'
Example Response
{  "subscription_id": "aa11a4c2-a467-43db-b413-c4ab0f5cf627",  "session_count": 1,  "last_seen_at": "2019-08-24T14:15:22Z"}