---
title: "Set Key Webhook"
method: POST
path: "/v1/webhooks/api-key"
tags: ["Webhooks"]
---

# Set Key Webhook

`POST /v1/webhooks/api-key`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/webhooks/api-key`
- Auth: HTTP bearer

Register one notify-only URL for the API key authenticating this request.

Only ooctoo@monid.ai is eligible. The URL receives call/SMS events for
numbers provisioned or explicitly assigned to this key. It takes precedence
over the account-wide URL for those numbers. Save the returned signing secret.

## Request body

- ApiKeyWebhookConfig
  - `url` string, uri, required
  - `secret` string, nullable
  - `signature_header` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)