v1

latestOpenAPI 3.0.3Proprietaryraw.githubusercontent.com2026-03-067260437.0 KB

Webhooks

Update webhook

Update an existing webhook's configuration. All fields are optional.

gigstack Connect: Update webhooks for other teams using the team parameter.

put/webhooks/{id}

Path parameters

idstring required

Example:wh_dyS2ZVTj

Webhook ID

Query parameters

teamstring

gigstack Connect: Target team ID for multi-team access.

Requires gigstack Connect enabled on your team and shared billing account.

Example: ?team=team_xyz789

Request body

urlstring url nullable

HTTPS endpoint URL to receive webhook events

eventsstring[] nullable

Array of event types to subscribe to

descriptionstring nullable

Optional description of the webhook purpose

status'active' | 'inactive' nullable

Webhook status - active or inactive

Example request

{
  "url": "https://new-domain.com/webhooks/gigstack",
  "events": [
    "payment.created",
    "payment.succeeded",
    "invoice.created"
  ],
  "description": "Updated webhook description",
  "status": "inactive"
}

Response

Webhook updated successfully

successboolean

messagestring

Example response

{
  "success": true,
  "message": "Webhook updated successfully",
  "data": {
    "id": "wh_dyS2ZVTj",
    "url": "https://your-domain.com/webhooks/gigstack",
    "events": [
      "payment.created",
      "payment.succeeded",
      "invoice.created"
    ],
    "status": "active",
    "description": "Production payment notifications",
    "owner": "8UWdgXELUhf022vuoq249mtGytG2",
    "created_at": 1709090576567
  }
}