API referenceWebhook events

connection.activated

A company approved this app connection. Lockii POSTs this body to the app webhook URL. Headers are Lockii-Event-Id, Lockii-Event-Type, and Lockii-Signature (t=<unix seconds>,v1=<hex hmac-sha256 of "<t>.<raw body>" using the app webhook secret). Respond with any 2xx or the delivery is retried.

Headers

Lockii-Event-Id
string
required
Same value as the JSON id.
Lockii-Event-Type
string
required
Same value as the JSON type.
Lockii-Signature
string
t=<unix seconds>,v1=<hex hmac-sha256 of "<t>.<raw body>">, signed with the app webhook secret.

Body

application/json

connection_id
string
required
App installation id.
created_at
string
required
ISO-8601 timestamp.
data
object
required
id
string
required
Event id, evt_<uuid>.
type
enum<string>
required
One of:
connection.activated

Example payload

{
  "connection_id": "string",
  "created_at": "string",
  "data": {
    "external_account_id": "string"
  },
  "id": "string",
  "type": "connection.activated"
}

Your response

200

Any 2xx acknowledges the delivery. Any other response is treated as a failure.

- Introduction
- User MCP
- Customer MCP
- Booking API
- Building a Lockii App
- Login with Lockii
- Building a Marketplace App

API referenceWebhook events

connection.activated

A company approved this app connection. Lockii POSTs this body to the app webhook URL. Headers are Lockii-Event-Id, Lockii-Event-Type, and Lockii-Signature (t=<unix seconds>,v1=<hex hmac-sha256 of "<t>.<raw body>" using the app webhook secret). Respond with any 2xx or the delivery is retried.

Headers

Lockii-Event-Id
string
required
Same value as the JSON id.
Lockii-Event-Type
string
required
Same value as the JSON type.
Lockii-Signature
string
t=<unix seconds>,v1=<hex hmac-sha256 of "<t>.<raw body>">, signed with the app webhook secret.

Body

application/json

connection_id
string
required
App installation id.
created_at
string
required
ISO-8601 timestamp.
data
object
required
id
string
required
Event id, evt_<uuid>.
type
enum<string>
required
One of:
connection.activated

Example payload

{
  "connection_id": "string",
  "created_at": "string",
  "data": {
    "external_account_id": "string"
  },
  "id": "string",
  "type": "connection.activated"
}

Your response

200

Any 2xx acknowledges the delivery. Any other response is treated as a failure.