Create and publish a consent notice

This tutorial will walk you through the steps necessary to create a notice, modify its configuration, and publish it.
Create a consent notice
To create a consent notice, send a POST /widgets/notices request with the name of the notice to create and the ID of the organization that the notice belongs to:
Node.js
HTTP
1
const bent = require("bent");
2
​
3
const organizationId = "<organizationId>";
4
const token = "<token>"; // Get a token by authenticating in the API (https://developers.didomi.io/api/introduction/authentication)
5
​
6
const client = {
7
  post: bent(
8
    "POST",
9
    "https://api.didomi.io/v1",
10
    "json",
11
    {
12
      Authorization: `Bearer ${token}`,
13
    },
14
    201
15
  ),
16
};
17
​
18
(async () => {
19
  console.log(
20
    `Creating a notice for organization ${organizationId} ...`
21
  );
22
​
23
  const notice = await client.post("/widgets/notices", {
24
    organization_id: organizationId,
25
    name: "My consent notice",
26
  });
27
​
28
  console.log(`Notice with ID ${notice.id} created!`);
29
})();
POST https://api.didomi.io/v1/widgets/notices
​
BODY
{
    "organization_id": "didomi",
    "name": "My consent notice"
}
The API will return a response similar to:
{
    "name": "My consent notice",
    "archived_at": null,
    "organization_id": "didomi",
    "id": "7wmRYUH6",
    "created_at": "2021-03-27T08:38:10.831Z",
    "updated_at": "2021-03-27T08:38:10.831Z",
    "version": 0
}
Modify the notice configuration
The API automatically created a draft configuration when a notice was created. To update the notice configuration, you must first get the ID of the draft configuration and then modify that draft configuration.
Get the ID of the draft configuration
To get the ID of the draft configuration, get the list of all configurations:
Node.js
HTTP
1
const bent = require("bent");
2
​
3
const organizationId = "<organizationId>";
4
const noticeId = "<noticeId>";
5
const token = "<token>"; // Get a token by authenticating in the API (https://developers.didomi.io/api/introduction/authentication)
6
​
7
const client = {
8
  get: bent("GET", "https://api.didomi.io/v1", "json", {
9
    Authorization: `Bearer ${token}`,
10
  }),
11
  patch: bent("PATCH", "https://api.didomi.io/v1", "json", {
12
    Authorization: `Bearer ${token}`,
13
  }),
14
  post: bent(
15
    "POST",
16
    "https://api.didomi.io/v1",
17
    "json",
18
    {
19
      Authorization: `Bearer ${token}`,
20
    },
21
    201
22
  ),
23
};
24
​
25
(async () => {
26
  console.log(
27
    `Querying the organization: ${organizationId} and the notice: ${noticeId}`
28
  );
29
​
30
  // Get the notice configs for the organization and notice
31
  console.log("Getting the latest draft config ...");
32
  const request = await client.get(
33
    `/widgets/notices/configs?organization_id=${organizationId}&notice_id=${noticeId}`
34
  );
35
  const noticeConfigs = request.data;
36
​
37
  // Filter the notice configs to get the draft config.
38
  const draftConfig = noticeConfigs.filter((e) => e.deployed_at === null).pop();
39
  const draftConfigId = draftConfig.id;
40
})();
1
GET https://api.didomi.io/v1/widgets/notices/configs?organization_id=didomi&notice_id=7wmRYUH6
2
​
3
{
4
    "total": 1,
5
    "limit": 100,
6
    "skip": 0,
7
    "data": [
8
        {
9
            "deployed_at": null,
10
            "custom_json": {},
11
            "config": { ... },
12
            "default": false,
13
            "platform": "web",
14
            "targets": [],
15
            "text_mode": "approved",
16
            "text_id": "W37f3Bmd",
17
            "full_atp": false,
18
            "enable_ignore_consent_before": false,
19
            "ignore_consent_before": null,
20
            "negative_action": "button",
21
            "disagree_button_style": "primary",
22
            "country": null,
23
            "notice_deny_applies_to_li": true,
24
            "preferences_deny_applies_to_li": true,
25
            "consent_duration": 12,
26
            "consent_duration_unit": "months",
27
            "notice_id": "7wmRYUH6",
28
            "organization_id": "didomi",
29
            "id": "7bKP4CRr",
30
            "created_at": "2021-03-27T08:38:15.248Z",
31
            "updated_at": "2021-03-27T08:38:15.248Z",
32
            "version": 0
33
        }
34
    ]
35
}
The configuration is called "draft" because its deployed_at field is null which indicates that this configuration has not been published before and can be modified.
As we are working with a newly created notice in this tutorial, we can assume that it has a single associated configuration and that it is a draft. If you are working with an existing notice that might have been published before and would have multiple configurations, read our documentation to find the current draft documentation. 
Modify the draft configuration
To modify the draft configuration, send a PATCH request with the updated configuration:
Node.js
HTTP
1
const bent = require("bent");
2
const { merge } = require("lodash");
3
​
4
const organizationId = "<organizationId>";
5
const noticeId = "<noticeId>";
6
const token = "<token>>"; // Get a token by authenticating in the API (https://developers.didomi.io/api/introduction/authentication)
7
​
8
const client = {
9
  get: bent("GET", "https://api.didomi.io/v1", "json", {
10
    Authorization: `Bearer ${token}`,
11
  }),
12
  patch: bent("PATCH", "https://api.didomi.io/v1", "json", {
13
    Authorization: `Bearer ${token}`,
14
  }),
15
  post: bent(
16
    "POST",
17
    "https://api.didomi.io/v1",
18
    "json",
19
    {
20
      Authorization: `Bearer ${token}`,
21
    },
22
    201
23
  ),
24
};
25
​
26
(async () => {
27
  console.log(
28
    `Querying the organization: ${organizationId} and the notice: ${noticeId}`
29
  );
30
​
31
  // Get the notice configs for the organization and notice
32
  console.log("Getting the latest draft config ...");
33
  const request = await client.get(
34
    `/widgets/notices/configs?organization_id=${organizationId}&notice_id=${noticeId}`
35
  );
36
  const noticeConfigs = request.data;
37
​
38
  // Filter the notice configs to get the draft config.
39
  const draftConfig = noticeConfigs.filter((e) => e.deployed_at === null).pop();
40
  const draftConfigId = draftConfig.id;
41
​
42
  // Modify the notice configuration
43
  console.log("Updating the latest draft config ...");
44
  await client.patch(
45
    `/widgets/notices/configs/${draftConfigId}`,
46
    merge(draftConfig, {
47
      consent_duration: 6, // Change the consent duration for the notice
48
      consent_duration_unit: "months",
49
    })
50
  );
51
})();
PATCH https://api.didomi.io/v1/widgets/notices/configs/7bKP4CRr
​
{
    "platform": "app",
    "consent_duration": 6,
    "consent_duration_unit": "months"
}
Publish the notice
Now that our notice is configured as we want it to be, we need to publish it so that our modified configuration appears in the actual notice on the website or app.
To publish a notice, we need to create a new deployment for that notice:
Node.js
HTTP
1
const bent = require("bent");
2
const { merge } = require("lodash");
3
​
4
const organizationId = "<organizationId>";
5
const noticeId = "<noticeId>";
6
const token = "<token>"; // Get a token by authenticating in the API (https://developers.didomi.io/api/introduction/authentication)
7
​
8
const client = {
9
  get: bent("GET", "https://api.didomi.io/v1", "json", {
10
    Authorization: `Bearer ${token}`,
11
  }),
12
  patch: bent("PATCH", "https://api.didomi.io/v1", "json", {
13
    Authorization: `Bearer ${token}`,
14
  }),
15
  post: bent(
16
    "POST",
17
    "https://api.didomi.io/v1",
18
    "json",
19
    {
20
      Authorization: `Bearer ${token}`,
21
    },
22
    201
23
  ),
24
};
25
​
26
(async () => {
27
  console.log(
28
    `Querying the organization: ${organizationId} and the notice: ${noticeId}`
29
  );
30
​
31
  // Get the notice configs for the organization and notice
32
  console.log("Getting the latest draft config ...");
33
  const request = await client.get(
34
    `/widgets/notices/configs?organization_id=${organizationId}&notice_id=${noticeId}`
35
  );
36
  const noticeConfigs = request.data;
37
​
38
  // Filter the notice configs to get the draft config.
39
  const draftConfig = noticeConfigs.filter((e) => e.deployed_at === null).pop();
40
  const draftConfigId = draftConfig.id;
41
​
42
  // Modify the notice configuration
43
  console.log("Updating the latest draft config ...");
44
  await client.patch(
45
    `/widgets/notices/configs/${draftConfigId}`,
46
    merge(draftConfig, {
47
      consent_duration: 6, // Change the consent duration for the notice
48
      consent_duration_unit: "months",
49
    })
50
  );
51
​
52
  // Publish the notice configuration
53
  console.log("Publishing the draft config ...");
54
  const response = await client.post(`/widgets/notices/deployments`, {
55
    notice_id: noticeId,
56
    organization_id: organizationId,
57
    production_config_id: draftConfigId,
58
    message: "Message describing the content of the update to the notice",
59
  });
60
​
61
  console.log(`Your deployment is a ${response.status}!`);
62
})();
POST https://api.didomi.io/v1/widgets/notices/deployments
​
BODY
{
    "notice_id": "7wmRYUH6",
    "organization_id": "didomi",
    "production_config_id": "7bKP4CRr",
    "message": "Description of changes included in my deployment"
}
The production_config_id should be the ID of the draft config you are publishing. message is a text field that can be used to indicate information on what changes are included in your deployment.
The API responds with the status of your deployment:
{
    "message": "Description of changes included in my deployment",
    "notice_id": "7wmRYUH6",
    "production_config_id": "7bKP4CRr",
    "organization_id": "didomi",
    "status": "success",
    "status_message": null,
    "id": "itBtwnxM",
    "created_at": "2021-03-27T08:53:07.467Z",
    "updated_at": "2021-03-27T08:53:07.467Z",
    "version": 0
}
What's next?
The Didomi API allows managing all aspects of consent notices and their configurations. Read more about the entities to learn how to do more complex operations.​
​
Tutorials
Privacy widgets
Last modified 1mo ago