---
title: "Create or update webhook applications."
method: POST
path: "/webhook_application/upsert"
tags: ["Webhook|Application"]
---

# Create or update webhook applications.

`POST /webhook_application/upsert`

This endpoint enables you to create or update webhook applications.

## Request body

- StandardWebhookApplicationUpsertRequest
  - `records` object[] — The records. This Parameter is optional.
    - `keyField` string — This parameter specifies the name of the unique key used to distinctly assign each dataset in the API. | Value | Description | |----------------|------------------------------------| | id | The internal application ID | | externalid | The external application ID |
    - `data` WebhookApplicationUpsertRequestRecordData
      - `id` string — The internal id of the application.
      - `externalId` string — The external id of the application. (max. 255 characters)
      - `name` string — The name of the application. (max. 255 characters)
      - `description` string — The description of the application.
      - `active` boolean — The active flag.
      - `baseUrl` string — The base url of the application. (max. 255 characters)
  - `dryRun` boolean — Simulate the operation. (No records will be created or changed) This Parameter is optional.

## Response `200`

Success Response:

- StandardWebhookApplicationUpsertResponse
  - `createdApplications` object[] — The created applications.
    - `id` string — The internal id of the application.
    - `name` string — The name of the application.
    - `externalId` string — The external id of the application.
    - `description` string — The description of the application.
    - `active` boolean — Is the application active?
    - `baseUrl` string — The base url of the application.
  - `updatedApplications` object[] — The updated applications.
    - `id` string — The internal id of the application.
    - `name` string — The name of the application.
    - `externalId` string — The external id of the application.
    - `description` string — The description of the application.
    - `active` boolean — Is the application active?
    - `baseUrl` string — The base url of the application.

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/869b05603541/schema)