---
title: "Retrieve single webhook subscription."
method: GET
path: "/subscriptions/{id}"
tags: ["subscriptions"]
---

# Retrieve single webhook subscription.

`GET /subscriptions/{id}`

## Request

- Base URL: `https://api.smartrecruiters.com/webhooks-api/v201907`
- URL: `https://api.smartrecruiters.com/webhooks-api/v201907/subscriptions/{id}`
- 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`

## Response `200`

Subscription details.

- Subscription
  - `id` string
  - `name` string, nullable
  - `description` string, nullable
  - `callbackUrl` string, https_url, required
  - `events` Event[], required
    - `name` 'job.created' | 'job.updated' | 'job.status.updated' | 'job.hiring-team.updated' | 'job.ad.created' | 'job.ad.updated' | 'job.ad.postings.updated' | 'position.created' | 'position.updated' | 'position.deleted' | 'application.created' | 'application.status.updated' | 'application.fields.updated' | 'application.onboarding-status.updated' | 'application.attachment.created' | 'application.source.updated' | 'candidate.created' | 'candidate.updated' | 'candidate.deleted' | 'offer.created' | 'offer.updated' | 'offer.approval.created' | 'offer.approval.approved' | 'offer.approval.rejected' | 'offer.approval.abandoned' | 'offer.approval.step.approved' | 'offer.approval.step.rejected' | 'offer.approver.skipped' | 'offer.approver.delegated' | 'offer.approval.comment.created' | 'job.approval.created' | 'job.approval.approved' | 'job.approval.rejected' | 'job.approval.abandoned' | 'job.approval.step.approved' | 'job.approval.step.rejected' | 'job.approver.skipped' | 'job.approver.delegated' | 'job.approval.comment.created' | 'review.created' | 'review.updated' | 'review.deleted' | 'application.screening-answers.created' | 'application.screening-answers.updated' | 'onboarding.process.started' | 'onboarding.assignments.high-priority.completed' | 'onboarding.assignments.completed' | 'onboarding.assignment.integration-relevant.completed' | 'onboarding.assignments.integration-relevant.completed' | 'interview.created' | 'interview.updated' | 'interview.canceled' | 'self-schedule.created' | 'winston.chat.visibility.changed'
    - `version` string
  - `status` 'inactive' | 'active'

## Other responses

- `403`: No permission to see this 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)