Add Webhook

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/webhooks' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com/url",
    "all_events": false,
    "description": "Example description",
    "events": [
      "example"
    ]
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "secret": "example",
    "webhook": {
      "all_events": false,
      "created_at": 1760000000,
      "description": "Example description",
      "events": [
        "example"
      ],
      "secret_last4": "example",
      "status": "enabled",
      "url": "https://example.com/url",
      "webhook_id": "b5f1a133e89a12f450352f1f50843c42",
      "created_by_member_id": "cb17cae3f79d7fd264472475d7d5d2fe",
      "last_delivery_at": 1760000000,
      "last_delivery_succeeded": false,
      "previous_secret_expires_at": 1760000000,
      "secret_rotated_at": 1760000000
    }
  }
}

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/webhooks' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com/url",
    "all_events": false,
    "description": "Example description",
    "events": [
      "example"
    ]
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "secret": "example",
    "webhook": {
      "all_events": false,
      "created_at": 1760000000,
      "description": "Example description",
      "events": [
        "example"
      ],
      "secret_last4": "example",
      "status": "enabled",
      "url": "https://example.com/url",
      "webhook_id": "b5f1a133e89a12f450352f1f50843c42",
      "created_by_member_id": "cb17cae3f79d7fd264472475d7d5d2fe",
      "last_delivery_at": 1760000000,
      "last_delivery_succeeded": false,
      "previous_secret_expires_at": 1760000000,
      "secret_rotated_at": 1760000000
    }
  }
}

POST /openapi/memorylake/admin/v1/webhooks

Adds an endpoint that receives the selected team events. The response carries the signing secret — the only time it is shown. Requests are signed the Standard Webhooks way (webhook-id, webhook-timestamp, webhook-signature). The endpoint must use https:// and resolve to a public address; a team can have at most 10 webhooks.

Permission required: webhook:manage

Request Body

string

required

Endpoint URL. Must start with https:// and must not resolve to a private, loopback or reserved address.

boolean

Send every event type, including types added in the future

string

Description, at most 100 characters

array

Event types to send (see List Event Types). Required unless all_events is true; unknown types are ignored.

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/webhooks' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com/url",
    "all_events": false,
    "description": "Example description",
    "events": [
      "example"
    ]
  }'

Response

object

Show Webhook With Secret object

string

Signing secret (whsec_…). Shown only in this response — store it now; a lost secret can only be rotated.

object

Show Webhook object

boolean

true = every event type is sent, including types added in the future; events is then the selection kept for when this is switched off

integer

When the webhook was added, Unix seconds

string

Description; empty when none was given

array

Selected event types (see List Event Types)

string

Last four characters of the current signing secret. The full secret is returned only by Add Webhook and Rotate Signing Secret.

string

auto_disabled = turned off after every delivery failed for 3 days; enable it after fixing the endpoint. One of: enabled, disabled, auto_disabled.

string

Endpoint URL events are sent to

string

Identifier of the webhook

string

Member who added the webhook

integer

Time of the latest attempt, Unix seconds; absent if nothing was sent yet

boolean

Whether the latest delivery succeeded

integer

Until when the previous secret still signs requests after a rotation, Unix seconds; absent outside that window

integer

When the signing secret was last rotated, Unix seconds; absent if never

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "secret": "example",
    "webhook": {
      "all_events": false,
      "created_at": 1760000000,
      "description": "Example description",
      "events": [
        "example"
      ],
      "secret_last4": "example",
      "status": "enabled",
      "url": "https://example.com/url",
      "webhook_id": "b5f1a133e89a12f450352f1f50843c42",
      "created_by_member_id": "cb17cae3f79d7fd264472475d7d5d2fe",
      "last_delivery_at": 1760000000,
      "last_delivery_succeeded": false,
      "previous_secret_expires_at": 1760000000,
      "secret_rotated_at": 1760000000
    }
  }
}

Errors

Errors answer with success: false, a message and an error_code. See Error Codes for every code.

Status	Meaning
`400`	A parameter or the body is invalid
`401`	The API key is missing, invalid, disabled or expired
`403`	The key is not allowed to do this
`404`	The resource does not exist
`409`	The request conflicts with the current state, e.g. a duplicate or a limit reached
`422`	The body or a parameter failed validation
`429`	Too many requests. Wait for the time in `Retry-After`
`500`	Server-side error

MemoryLake API

Memory Router API

Request Body

Response

Errors

​Request Body

​Response

​Errors

Request Body

Response

Errors