hookdeck/integrations/hookdeck-github.yaml at main · api-evangelist/hookdeck · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
naftiko: 1.0.0-alpha2
info:
  label: Trigger GitHub Actions workflows from Hookdeck events
  description: Use Hookdeck as the durable entrypoint for inbound webhooks (vendor events, partner callbacks, IoT pings) and route them to a GitHub Actions repository-dispatch destination so workflows fire reliably with full retry and replay history.
  tags:
  - Hookdeck
  - Integration
  - CI / Workflows
  - github
  created: '2026-05-20'
  modified: '2026-05-20'
binds:
- namespace: env
  keys:
    HOOKDECK_API_KEY: HOOKDECK_API_KEY
    GITHUB_API_KEY: GITHUB_API_KEY
capability:
  consumes:
  - type: http
    namespace: hookdeck
    baseUri: https://api.hookdeck.com/2025-07-01
    description: Hookdeck API operations consumed by this integration.
    resources:
    - name: destinations
      path: /destinations
      operations:
      - name: createdestination
        method: POST
        description: Create a destination pointing at the GitHub repository-dispatch endpoint.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: connections
      path: /connections
      operations:
      - name: createconnection
        method: POST
        description: Connect the inbound source to the GitHub destination.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: transformations
      path: /transformations
      operations:
      - name: createtransformation
        method: POST
        description: Transform the incoming event into a repository-dispatch payload.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  - type: http
    namespace: github
    baseUri: https://api.github.com
    description: GitHub REST API operations consumed by this integration.
    resources:
    - name: repos-owner-repo-dispatches
      path: /repos/{owner}/{repo}/dispatches
      operations:
      - name: createrepositorydispatch
        method: POST
        description: 'GitHub REST API: createRepositoryDispatch'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: owner
          in: path
          type: string
          description: Path parameter owner.
          required: true
        - name: repo
          in: path
          type: string
          description: Path parameter repo.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: mcp
    namespace: hookdeck-github-mcp
    description: MCP adapter for the hookdeck-github integration.
    tools:
    - name: hookdeck_github
      description: Execute the hookdeck github integration end-to-end.
      inputSchema:
        type: object
        properties:
          trigger_event:
            type: object
            description: Triggering event payload.
        required:
        - trigger_event
  - type: rest
    namespace: hookdeck-github-rest
    port: 8080
    description: REST adapter for the hookdeck-github integration.
    resources:
    - path: /hookdeck-github
      name: hookdeck-github
      description: REST surface for the hookdeck-github integration.
      operations:
      - method: POST
        name: trigger
        description: Trigger the hookdeck-github integration.
        call: hookdeck_github
        with:
          trigger_event: rest.body
        outputParameters:
        - type: object
          mapping: $.