---
title: "Subscribe a URL"
method: POST
path: "/webhooks"
tags: ["Partner"]
---

# Subscribe a URL

`POST /webhooks`

## Request

- Base URL: `https://gigngo.org/api/v1`
- URL: `https://gigngo.org/api/v1/webhooks`
- Auth: API key in header `X-Api-Key`

Body { url, events }. Events: task.posted, task.assigned, task.completed, task.cancelled. The reply carries the secret once; each delivery is signed X-GigNGo-Signature: sha256=HMAC-SHA256(raw body, secret). Partner key with the `webhooks` scope.

## Response `200`

OK. data { id, url, events, secret }

---

[API](https://skmtc.dev/gigngo/apis/gigngo-public-api.md) · [All operations](https://skmtc.dev/gigngo/apis/gigngo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gigngo/apis/gigngo-public-api/revisions/20ef5bb7d13c?raw)