v1

latestOpenAPI 3.1.02026-07-2419603.1 MB
Data Activation

Update webhook import

Update single webhook import definition. Requires manage permission.

put/api/cdp/settings/v1/app/{app_id}/webhook-import/{id}

Request body

namestring required
identifiersobject

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

attributesobject

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_bodystring

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

Example request

{
  "identifiers": {
    "email": "user_id"
  },
  "attributes": {
    "url": "analytics.event_url",
    "user.age": "age",
    "transaction_id": "session_custom_dimension_5"
  },
  "status": "inactive",
  "test_request_body": "{\"user_id\":\"test\",\"total_revenue\":1}"
}

Response

Webhook import object after update