Create an organization webhook

POST

/orgs/{org}/hooks

Create a hook that posts payloads in JSON format.

You must be an organization owner to use this endpoint.

OAuth app tokens and personal access tokens (classic) need admin:org_hook scope. OAuth apps cannot list, view, or
edit webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.

リクエストパラメータ

パスパラメータ

リクエストボディパラメータapplication/json

例

レスポンス

🟢201Created

application/json

Response

Headers

ボディapplication/json

🟠404Record Not Found

🟠422Parameter Error

リクエストExample

Shell

JavaScript

Java

Swift

curl --location 'https://service1.exmaple.com/orgs//hooks' \
--header 'Content-Type: application/json' \
--data '{
    "name": "web",
    "active": true,
    "events": [
        "push",
        "pull_request"
    ],
    "config": {
        "url": "http://example.com/webhook",
        "content_type": "json"
    }
}'

レスポンスExample

201 - default

{
    "id": 1,
    "url": "https://api.github.com/orgs/octocat/hooks/1",
    "ping_url": "https://api.github.com/orgs/octocat/hooks/1/pings",
    "deliveries_url": "https://api.github.com/orgs/octocat/hooks/1/deliveries",
    "name": "web",
    "events": [
        "push",
        "pull_request"
    ],
    "active": true,
    "config": {
        "url": "http://example.com",
        "content_type": "json"
    },
    "updated_at": "2011-09-06T20:39:23Z",
    "created_at": "2011-09-06T17:26:27Z",
    "type": "Organization"
}

更新日時 2025-06-12 06:47:19

List organization webhooks

Get an organization webhook