---
title: "Retrieve subscription secret key"
method: GET
path: "/subscriptions/{id}/secret-key"
tags: ["subscriptions"]
---

# Retrieve subscription secret key

`GET /subscriptions/{id}/secret-key`

## Request

- Base URL: `https://api.smartrecruiters.com/webhooks-api/v201907`
- URL: `https://api.smartrecruiters.com/webhooks-api/v201907/subscriptions/{id}/secret-key`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `webhooks_read`, `webhooks_manage`

Retrieves the last secret key for webhook subscription.

## Response `200`

Subscription secret key.

- SecretKeyPayload
  - `secretKey` string

## Other responses

- `403`: No permission to retrieve secret key for webhook subscription.
- `404`: Subscription not found.

---

[API](https://skmtc.dev/smartrecruiters/apis/webhooks.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/webhooks/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/webhooks/revisions/52d7f629b537?raw)