---
title: "Register an OAuth/MCP client (identity-gated)"
method: POST
path: "/api/v1/register"
tags: ["v1"]
---

# Register an OAuth/MCP client (identity-gated)

`POST /api/v1/register`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/v1/register`
- Auth: none declared

Public + rate-limited. Requires a contact email + LinkedIn. Returns client credentials once; the client is pending platform approval (data endpoints return sample data until approved).

## Request body

- V1RegisterBody
  - `client_name` string, required
  - `redirect_uris` string[], required
  - `registrant_email` string, email, required
  - `registrant_linkedin` string, uri, required
  - `scope` string[]

## Response `201`

Client registered (pending approval)

- V1RegisterResponse
  - `client_id` string, required
  - `client_secret` string, required
  - `approval_status` string, required
  - `token_endpoint` string, required
  - `authorization_endpoint` string, required
  - `granted_scopes` string, required
  - `notice` string, required

## Other responses

- `400`: Validation error

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)