docs

List webhook endpoints

Lists all webhook endpoints for the merchant.

GET
/webhook-endpoints

Lists all webhook endpoints for the merchant.

Authorization

api-key
AuthorizationBearer <token>

API key for merchant integrations. Send as Authorization: Bearer <your key>.

In: header

Response Body

application/json

curl -X GET "https://example.com/webhook-endpoints"
{
  "object": "list",
  "data": [
    {
      "id": "we_abc123def456",
      "object": "webhook_endpoint",
      "url": "https://example.com/webhooks",
      "description": "Production webhook",
      "status": "enabled",
      "enabledEvents": [
        "charge.succeeded",
        "payment_intent.created"
      ],
      "livemode": false,
      "secret": "whsec_abc123def456ghi789",
      "metadata": {
        "environment": "production"
      },
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ]
}

Delete a price DELETE

Deletes a price. Only prices that have never been referenced by a line item can be deleted — once a price has been used in any checkout session or payment link, archive it instead. If the price is set as the default price for a product, the default price reference will be cleared.

Create a webhook endpoint POST

Creates a new webhook endpoint. The response includes the signing secret which is only shown once. Store it securely to verify webhook signatures.