Claim a one-time agent connector setup token

Used by external agent runtimes such as OpenClaw to finish agent connector setup. The setup token is generated in the authenticated Leadtime app, but this claim endpoint does not require Bearer auth. Claiming the token enables the agent webhooks/sessions connection, creates a fresh agent PAT, stores the webhook URL, and returns one-time secrets to the installer.

POST/agent-connectors/setup/claim

Authorization

AuthorizationOAuth2 access token · headerrequired

Request body

requiredapplication/json

agentIdstring

Runtime-specific agent id to attach this Leadtime agent to.

gatewayPublicUrlstringrequired

Public OpenClaw/Hermes gateway URL reachable by Leadtime for webhook delivery.

runtimeVersionstring

Connector/runtime version reported by the installer.

setupTokenstringrequired

One-time setup token generated from the agent settings page.

Responses

201

Connector setup was claimed and one-time secrets were returned.

401

Setup token is invalid, expired, or already used.

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

agentIdstringRuntime-specific agent id to attach this Leadtime agent to.gatewayPublicUrlstring*Public OpenClaw/Hermes gateway URL reachable by Leadtime for webhook delivery.runtimeVersionstringConnector/runtime version reported by the installer.setupTokenstring*One-time setup token generated from the agent settings page.

Request

curl -X POST "https://leadtime.app/api/public/agent-connectors/setup/claim" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "agentId": "main",
  "gatewayPublicUrl": "https://agent.example.com",
  "runtimeVersion": "openclaw-leadtime-plugin@0.1.0",
  "setupToken": "lt_conn_abc123"
}'

const response = await fetch("https://leadtime.app/api/public/agent-connectors/setup/claim", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"agentId\": \"main\",\n  \"gatewayPublicUrl\": \"https://agent.example.com\",\n  \"runtimeVersion\": \"openclaw-leadtime-plugin@0.1.0\",\n  \"setupToken\": \"lt_conn_abc123\"\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/agent-connectors/setup/claim",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"agentId\": \"main\",\n  \"gatewayPublicUrl\": \"https://agent.example.com\",\n  \"runtimeVersion\": \"openclaw-leadtime-plugin@0.1.0\",\n  \"setupToken\": \"lt_conn_abc123\"\n}",
)

Response

Connector setup was claimed and one-time secrets were returned.