Ketch

Usage Instructions

Integrate Ketch into the workflow. Retrieve and update consent preferences, manage subscription topics and controls, and submit data subject rights requests for access, deletion, correction, or processing restriction.

Tools

`ketch_get_consent`

Retrieve consent status for a data subject. Returns the current consent preferences for each configured purpose.

Input

Parameter	Type	Required	Description
`organizationCode`	string	Yes	Ketch organization code
`propertyCode`	string	Yes	Digital property code defined in Ketch
`environmentCode`	string	Yes	Environment code defined in Ketch (e.g., "production")
`jurisdictionCode`	string	No	Jurisdiction code (e.g., "gdpr", "ccpa")
`identities`	json	Yes	Identity map (e.g., {"email": "user@example.com"})
`purposes`	json	No	Optional purposes to filter the consent query

Output

Parameter	Type	Description
`purposes`	object	Map of purpose codes to consent status and legal basis
`vendors`	object	Map of vendor consent statuses

`ketch_set_consent`

Update consent preferences for a data subject. Sets the consent status for specified purposes with the appropriate legal basis.

Input

Parameter	Type	Required	Description
`organizationCode`	string	Yes	Ketch organization code
`propertyCode`	string	Yes	Digital property code defined in Ketch
`environmentCode`	string	Yes	Environment code defined in Ketch (e.g., "production")
`jurisdictionCode`	string	No	Jurisdiction code (e.g., "gdpr", "ccpa")
`identities`	json	Yes	Identity map (e.g., {"email": "user@example.com"})
`purposes`	json	Yes	Map of purpose codes to consent settings (e.g., {"analytics": {"allowed": "granted", "legalBasisCode": "consent_optin"}})
`collectedAt`	number	No	UNIX timestamp when consent was collected (defaults to current time)

Output

Parameter	Type	Description
`purposes`	object	Updated consent status map of purpose codes to consent settings

`ketch_get_subscriptions`

Retrieve subscription preferences for a data subject. Returns the current subscription topic and control statuses.

Input

Parameter	Type	Required	Description
`organizationCode`	string	Yes	Ketch organization code
`propertyCode`	string	Yes	Digital property code defined in Ketch
`environmentCode`	string	Yes	Environment code defined in Ketch (e.g., "production")
`identities`	json	Yes	Identity map (e.g., {"email": "user@example.com"})

Output

Parameter	Type	Description
`topics`	object	Map of topic codes to contact method settings (e.g., {"newsletter": {"email": {"status": "granted"}}})
`controls`	object	Map of control codes to settings (e.g., {"global_unsubscribe": {"status": "denied"}})

`ketch_set_subscriptions`

Update subscription preferences for a data subject. Sets topic and control statuses for email, SMS, and other contact methods.

Input

Parameter	Type	Required	Description
`organizationCode`	string	Yes	Ketch organization code
`propertyCode`	string	Yes	Digital property code defined in Ketch
`environmentCode`	string	Yes	Environment code defined in Ketch (e.g., "production")
`identities`	json	Yes	Identity map (e.g., {"email": "user@example.com"})
`topics`	json	No	Map of topic codes to contact method settings (e.g., {"newsletter": {"email": {"status": "granted"}, "sms": {"status": "denied"}}})
`controls`	json	No	Map of control codes to settings (e.g., {"global_unsubscribe": {"status": "denied"}})

Output

Parameter	Type	Description
`success`	boolean	Whether the subscription preferences were updated

`ketch_invoke_right`

Submit a data subject rights request (e.g., access, delete, correct, restrict processing). Initiates a privacy rights workflow in Ketch.

Input

Parameter	Type	Required	Description
`organizationCode`	string	Yes	Ketch organization code
`propertyCode`	string	Yes	Digital property code defined in Ketch
`environmentCode`	string	Yes	Environment code defined in Ketch (e.g., "production")
`jurisdictionCode`	string	Yes	Jurisdiction code (e.g., "gdpr", "ccpa")
`rightCode`	string	Yes	Privacy right code to invoke (e.g., "access", "delete", "correct", "restrict_processing")
`identities`	json	Yes	Identity map (e.g., {"email": "user@example.com"})
`userData`	json	No	Optional data subject information (e.g., {"email": "user@example.com", "firstName": "John", "lastName": "Doe"})

Output

Parameter	Type	Description
`success`	boolean	Whether the rights request was submitted
`message`	string	Response message from Ketch

Notes

Category: tools
Type: ketch

Ketch

On this page