---
title: "GET /openclaw/callback"
method: GET
path: "/openclaw/callback"
---

# GET /openclaw/callback

`GET /openclaw/callback`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/openclaw/callback`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `code` string: OAuth authorization code returned by the provider
- `state` string: State parameter for CSRF verification
- `error` string: Error code if the authorization was denied or failed

## Response `200`

OK

- object: Result of processing the OpenClaw OAuth callback
  - `enabled` boolean, required: Whether OpenClaw integration is enabled
  - `state` string, nullable, required: State parameter echoed back for verification
  - `agent` object, nullable, required: OpenClaw agent profile information
    - `id` string, required: OpenClaw agent unique identifier
    - `email` string, email, required: Agent email address
    - `name` string, required: Agent display name
    - `handle` string: Agent handle or username
    - `avatarUrl` string, uri: URL to the agent avatar image
    - `metadata` object: Additional profile metadata from OpenClaw
  - `tokens` object, nullable, required: OAuth token credentials for the OpenClaw integration
    - `accessToken` string, required: OAuth access token for API calls
    - `refreshToken` string, required: OAuth refresh token for obtaining new access tokens
    - `expiresAt` string, date-time, required: Timestamp when the access token expires

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)