# Verify webhook subscription

**POST /api/v1/webhooks/subscriptions/{subscriptionId}/verify**

Sends a `webhook.verification` challenge to the subscription targetUrl. The callback must return any 2xx response. Verification challenges use the same signed callback header contract as deliveries. Unverified subscriptions can retry this endpoint after the verification cooldown. Verified subscriptions return their current details.


## Servers
- https://api.staging.lumetrade.com: https://api.staging.lumetrade.com ()



## Parameters
### Headers

- **X-API-KEY** (string)
  Public API key issued from the Lumetrade API key management flow.

- **X-API-SECRET** (string)
  API secret paired with the public API key.


### Path parameters

- **subscriptionId** (string)
  Webhook subscription id.




## Responses
### 200
Webhook subscription verified or already verified

#### Body: application/json (object)
- **id** (string)
  Public webhook subscription id.

- **name** (string)
  Optional customer label.

- **targetUrl** (string)
  Public HTTPS callback URL.

- **status** (string)
  Subscription status. PENDING_VERIFICATION requires verify before activation. INACTIVE subscriptions receive no new deliveries. DISABLED subscriptions are not customer re-enabled in v1.

- **events** (array[object])
  Customer-facing webhook event catalog entry.

- **verifiedAt** (string(date-time))
  UTC timestamp when the callback endpoint was last verified.

- **createdAt** (string(date-time))
  UTC creation timestamp.

- **updatedAt** (string(date-time))
  UTC last update timestamp.


### 400
Request validation failed

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 404
Resource was not found for the authenticated API key owner

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 429
Cloudflare API rate limit exceeded

#### Body: application/json (object)
- **error** (string)

- **message** (string)


### 403
Authenticated API key is not allowed to perform this action

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 401
API key authentication failed

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 500
Unexpected server error

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])



[Powered by Bump.sh](https://bump.sh)