---
title: "Create webhook import"
method: POST
path: "/api/cdp/settings/v1/app/{app_id}/webhook-import"
tags: ["Data Activation"]
---

# Create webhook import

`POST /api/cdp/settings/v1/app/{app_id}/webhook-import`

Create a new webhook import definition. Webhook import ID is optional, if absent, it'll be randomly generated. Requires manage permission.

## Request body

- object — Data necessary for creating a webhook import.
  - `id` string, uuid — ID of the webhook import
  - `name` string, required
  - `identifiers` object — Mapping of incoming keys to profile identifiers, only `cookie_id` or `user_id` allowed as values for now.
  - `attributes` object — Mapping of incoming keys to event data keys
  - `status` 'active' | 'inactive', required — Whether the webhook import is active. Cannot be toggled if webhook import has no identifiers or attributes.
  - `test_request_body` string — JSON body of the webhook request to store temporarily for setting up the webhook import attribute mappings.

## Response `201`

Created webhook import object.

## Other responses

- `400` — Bad request response (e.g. missing GET parameter, parameter value out of bounds)
- `401` — Access token is missing or invalid
- `402` — Data Activation module is disabled
- `404` — Resource not found (bad ID or resource deleted)
- `500` — Internal application error response (some service encountered unexpected error)

---

[API](https://skmtc.dev/piwik/apis/web-api.md) · [All operations](https://skmtc.dev/piwik/apis/web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/piwik/web-api/revisions/f63416a36168/schema)