---
title: "Create Webhook Subscription"
method: POST
path: "/api/v1/academies/{academy_id}/webhook_subscriptions"
---

# Create Webhook Subscription

`POST /api/v1/academies/{academy_id}/webhook_subscriptions`

## Request

- Base URL: `https://app.workramp.com`
- URL: `https://app.workramp.com/api/v1/academies/{academy_id}/webhook_subscriptions`
- Auth: API key in header `Authorization`

## Path parameters

- `academy_id` string, required

## Headers

- `Authorization` string
- `Content-Type` string

## Request body

- object
  - `webhookName` string, required: Descriptive name
  - `url` string, required: HTTPS endpoint
  - `eventTypes` string[], required: Valid event types

## Response `200`

200

- object
  - `webhookID` string
  - `webhookName` string
  - `url` string
  - `eventTypes` string[]

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/workramp/apis/json-api.md) - [All operations](https://skmtc.dev/workramp/apis/json-api/llms.txt) - [OpenAPI document](https://skmtc.dev/workramp/apis/json-api/revisions/2cb77bf12793?raw)