---
title: "Create a webhook"
method: POST
path: "/groups/{groupId}/apps/{appId}/services/{serviceId}/incoming_webhooks"
tags: ["webhooks"]
---

# Create a webhook

`POST /groups/{groupId}/apps/{appId}/services/{serviceId}/incoming_webhooks`

## Request

- Base URL: `https://services.cloud.mongodb.com/api/admin/v3.0`
- URL: `https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/services/{serviceId}/incoming_webhooks`
- Auth: HTTP bearer

Create a webhook.

## Request body

- IncomingWebhook
  - `name` string, required
  - `function_source` string, required
  - `respond_result` boolean, required
  - `options` object
    - `secret` string
    - `secretAsQueryParam` boolean

## Response `201`

Successfully created.

---

[API](https://skmtc.dev/mongodb/apis/mongodb-atlas-app-services-admin-api.md) - [All operations](https://skmtc.dev/mongodb/apis/mongodb-atlas-app-services-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mongodb/apis/mongodb-atlas-app-services-admin-api/revisions/1365ab72bc03?raw)