Create webhook endpoint

Webhooks: Subscribe to real-time event notifications via HTTP callbacks. When events occur (tracking added, deliveries, status changes), quipteams sends a signed POST request to your endpoint.

Endpoint3 params

Parameters

Name	Type	Required	Description
`url`	string	yes	Callback URL (must use HTTPS)
`events`	string[]	yes	Array of event types to subscribe to.
`description`	string	no	Optional label for the endpoint

javascript

const response = await fetch(`https://api.quipteams.com/api/v1/webhooks`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "url": "https://your-app.com/webhooks/quip",
    "events": [
      "quote.*"
    ],
    "description": "Production handler"
  }),
});

const { data } = await response.json();
console.log(data);

Example Request Body

json

{
  "url": "https://your-app.com/webhooks/quip",
  "events": [
    "quote.*"
  ],
  "description": "Production handler"
}

Response

json

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "url": "https://your-app.com/webhooks/quip",
    "events": [
      "quote.tracking_added",
      "quote.delivered"
    ],
    "description": "Production handler",
    "is_active": true,
    "secret": "a1b2c3d4e5f6789...64_hex_chars",
    "created_at": "2026-03-08T10:00:00Z"
  }
}