Update a consent group
Updates name, description, or signupMode of a consent group. At least one field must be provided.
<Note>This endpoint is only available when the Consent Groups feature is enabled for your account.</Note>
Authentication
api-keystring
The API key should be passed in the request headers as api-key for authentication.
Path parameters
id
ID of the consent group to update
Request
This endpoint expects an object.
name
New name for the consent group (max 255 characters)
description
New description (max 500 characters)
signupMode
New signup mode
Response
Updated consent group
id
Unique identifier for the consent group
name
Display name of the consent group
signupMode
Controls how contacts are added to the group. manual — contacts are added explicitly via the API. automatic — contacts are added automatically at signup.
contactsCount
Number of contacts currently in this consent group
isDefault
Whether this is a system-created default consent group
createdAt
UTC date-time when the consent group was created (YYYY-MM-DDTHH:mm:ss.SSSZ)
updatedAt
UTC date-time when the consent group was last updated (YYYY-MM-DDTHH:mm:ss.SSSZ)
description
Optional description of the consent group
Errors
400
Bad Request Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error