Update webhook import

put https://{account}.piwik.pro/api/cdp/settings/v1/app/{app_id}/webhook-import/{id}

Update single webhook import definition

time	status	user agent
Retrieving recent requests…

Loading…

Responses

Response body

object

uuid

required

ID of the webhook import

author

object

required

Author of a webhook

string

required

Email of an author

name

string

required

length between 1 and 255

identifiers

object

Mapping of incoming keys to profile identifiers, only cookie_id or user_id allowed as values for now.

Has additional fields

attributes

object

Mapping of incoming keys to event data keys

Has additional fields

status

string

required

Whether the webhook import is active. Cannot be toggled if webhook import has no identifiers or attributes.

active inactive

test_request_body

string

JSON body of the webhook request to store temporarily for setting up the webhook import attribute mappings.

created_at

date-time

required

Time of the creation of the webhook import.

updated_at

date-time

required

Time when the webhook import's settings were updated.

Language

Credentials

Bearer

JWT

URL


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://example.piwik.pro/api/cdp/settings/v1/app/app_id/webhook-import/id \
3
     --header 'accept: application/vnd.api+json' \
4
     --header 'content-type: application/json' \
5
     --data '{"status":"active"}'


xxxxxxxxxx
19
 
1
{
2
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3
  "author": {
4
    "email": "author@piwik.pro"
5
  },
6
  "name": "string",
7
  "identifiers": {
8
    "email": "user_id"
9
  },
10
  "attributes": {
11
    "url": "analytics.event_url",
12
    "user.age": "age",
13
    "transaction_id": "session_custom_dimension_5"
14
  },
15
  "status": "inactive",
16
  "test_request_body": "{\"user_id\":\"test\",\"total_revenue\":1}",
17
  "created_at": "2022-10-17T09:49:16.123456Z",
18
  "updated_at": "2022-10-17T09:49:16.123456Z"
19
}

Update webhook import

Get the full experience

Analytics

200Webhook import object after update

400Bad request response (e.g. missing GET parameter, parameter value out of bounds)

401Access token is missing or invalid

402CDP module is disabled

404Resource not found (bad ID or resource deleted)

500Internal application error response (some service encountered unexpected error)

Get the full experience

Analytics