# POST Create a new webhook

Register a new webhook endpoint to receive event notifications.

- Source URL: https://www.signcustomiser.com/help/api/post-create-a-new-webhook/
- Markdown URL: https://www.signcustomiser.com/help/api/post-create-a-new-webhook.md
- Group: Webhooks
- Method: POST
- Path: /api/v2/webhooks
- Auth: Bearer token

## Body parameters

- topic (string, optional): No description provided.
- url (string, optional): No description provided.
- meta (array, optional): No description provided.

## Request body example

```json
{
  "topic": "product:created",
  "url": "https://example.com/webhook",
  "meta": []
}
```

## cURL example

```bash
curl https://web.signcustomiser.com/api/v2/webhooks \
  --request POST \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "topic": "product:created",
  "url": "https://example.com/webhook",
  "meta": []
}'
```

## Response examples

### 200 POST 200 example 1

```json
{
  "webhook": {
    "webhook_id": 1,
    "topic": "product:created",
    "url": "https://example.com/webhook",
    "status": "active",
    "secret": "abc123...",
    "meta": {},
    "created_at": "2024-01-01T00:00:00.000000Z",
    "updated_at": "2024-01-01T00:00:00.000000Z"
  }
}
```