---
title: "Create a New Outgoing Webhook"
method: POST
path: "/company/v1/webhooks"
tags: ["outgoing webhooks (usersService)"]
---

# Create a New Outgoing Webhook

`POST /company/v1/webhooks`

Creates a new outgoing webhook with specified details.

## Request body

- CreateOutgoingWebhookDto
  - `url` string, uri, required — Should be unique per portal
  - `active` boolean
  - `events` OutgoingWebhookEvent[], required
    - `service` 'crm' | 'tasks' | 'news_feed' | 'comments', required
    - `type` 'post' | 'comment' | 'task' | 'entity_crm', required
    - `table_name` string, nullable
    - `actions` string[], required

## Response `201`

OK

- OutgoingWebhook
  - `id` integer
  - `url` string, uri — Should be unique per portal
  - `active` boolean
  - `user_id` integer
  - `confirmed` boolean
  - `created_at` integer
  - `updated_at` integer
  - `events` OutgoingWebhookEvent[]
    - `service` 'crm' | 'tasks' | 'news_feed' | 'comments', required
    - `type` 'post' | 'comment' | 'task' | 'entity_crm', required
    - `table_name` string, nullable
    - `actions` string[], required

## Other responses

- `401` — Access token is missing or invalid
- `403` — Forbidden
- `422` — Validation error response

---

[API](https://skmtc.net/uspacy/apis/uspacy-api-2.md) · [All operations](https://skmtc.net/uspacy/apis/uspacy-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uspacy/uspacy-api-2/revisions/c3f48fd1c26b/schema)