@connectedxm/admin-sdk 11.23.0 → 12.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/.openapi-generator/FILES +42 -2
  2. package/AdminApi.ts +9 -0
  3. package/README.md +2 -2
  4. package/api.ts +2923 -374
  5. package/base.ts +1 -1
  6. package/common.ts +1 -1
  7. package/configuration.ts +1 -1
  8. package/dist/AdminApi.d.ts +4 -1
  9. package/dist/AdminApi.js +3 -0
  10. package/dist/api.d.ts +1558 -155
  11. package/dist/api.js +2127 -324
  12. package/dist/base.d.ts +1 -1
  13. package/dist/base.js +1 -1
  14. package/dist/common.d.ts +1 -1
  15. package/dist/common.js +1 -1
  16. package/dist/configuration.d.ts +1 -1
  17. package/dist/configuration.js +1 -1
  18. package/dist/esm/AdminApi.d.ts +4 -1
  19. package/dist/esm/AdminApi.js +4 -1
  20. package/dist/esm/api.d.ts +1558 -155
  21. package/dist/esm/api.js +2081 -291
  22. package/dist/esm/base.d.ts +1 -1
  23. package/dist/esm/base.js +1 -1
  24. package/dist/esm/common.d.ts +1 -1
  25. package/dist/esm/common.js +1 -1
  26. package/dist/esm/configuration.d.ts +1 -1
  27. package/dist/esm/configuration.js +1 -1
  28. package/docs/Announcement.md +10 -24
  29. package/docs/AnnouncementAudience.md +44 -0
  30. package/docs/AnnouncementAudienceCondition.md +98 -0
  31. package/docs/AnnouncementAudienceConditionAccountAttribute.md +26 -0
  32. package/docs/AnnouncementAudienceConditionChoice.md +22 -0
  33. package/docs/AnnouncementAudienceConditionComparator.md +14 -0
  34. package/docs/AnnouncementAudienceConditionCreateInputs.md +60 -0
  35. package/docs/AnnouncementAudienceConditionEvent.md +24 -0
  36. package/docs/AnnouncementAudienceConditionInputs.md +58 -0
  37. package/docs/AnnouncementAudienceConditionQuestion.md +24 -0
  38. package/docs/AnnouncementAudienceConditionReference.md +22 -0
  39. package/docs/AnnouncementAudienceConditionType.md +40 -0
  40. package/docs/AnnouncementAudienceConditionUpdateInputs.md +60 -0
  41. package/docs/AnnouncementAudienceCreateInputs.md +30 -0
  42. package/docs/AnnouncementAudienceFilter.md +32 -0
  43. package/docs/AnnouncementAudienceFilterCreateInputs.md +24 -0
  44. package/docs/AnnouncementAudienceFilterUpdateInputs.md +22 -0
  45. package/docs/AnnouncementAudienceOperator.md +10 -0
  46. package/docs/AnnouncementAudienceReference.md +26 -0
  47. package/docs/AnnouncementAudienceScope.md +24 -0
  48. package/docs/AnnouncementAudienceUpdateInputs.md +24 -0
  49. package/docs/AnnouncementCreateInputs.md +5 -13
  50. package/docs/AnnouncementFilters.md +4 -10
  51. package/docs/AnnouncementMergeField.md +24 -0
  52. package/docs/AnnouncementTemplate.md +32 -0
  53. package/docs/AnnouncementTemplateCreateInputs.md +26 -0
  54. package/docs/AnnouncementTemplateTranslation.md +30 -0
  55. package/docs/AnnouncementTemplateTranslationUpdateInputs.md +22 -0
  56. package/docs/AnnouncementTemplateUpdateInputs.md +26 -0
  57. package/docs/AnnouncementUpdateInputs.md +2 -2
  58. package/docs/AnnouncementsApi.md +69 -20
  59. package/docs/AnnouncementsAudiencesApi.md +698 -0
  60. package/docs/AnnouncementsTemplatesApi.md +281 -0
  61. package/docs/AnnouncementsTemplatesTranslationsApi.md +240 -0
  62. package/docs/BaseAnnouncement.md +6 -8
  63. package/docs/BaseAnnouncementAudience.md +36 -0
  64. package/docs/CreateAnnouncementAudience200Response.md +24 -0
  65. package/docs/CreateAnnouncementAudienceCondition200Response.md +24 -0
  66. package/docs/CreateAnnouncementAudienceFilter200Response.md +24 -0
  67. package/docs/CreateAnnouncementTemplate200Response.md +24 -0
  68. package/docs/{GetAnnouncementAudience200Response.md → GetAnnouncementAudienceAccounts200Response.md} +3 -3
  69. package/docs/GetAnnouncementAudiences200Response.md +26 -0
  70. package/docs/GetAnnouncementMergeFields200Response.md +24 -0
  71. package/docs/GetAnnouncementTemplateTranslation200Response.md +24 -0
  72. package/docs/GetAnnouncementTemplateTranslations200Response.md +26 -0
  73. package/docs/GetAnnouncementTemplates200Response.md +26 -0
  74. package/docs/LoginsApi.md +3 -58
  75. package/docs/SendAnnouncementPreviewRequest.md +20 -0
  76. package/docs/UpdateAnnouncementTemplateTranslation200Response.md +24 -0
  77. package/package.json +1 -1
  78. package/docs/EventAnnouncementFilters.md +0 -30
@@ -0,0 +1,32 @@
1
+ # AnnouncementAudienceFilter
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **id** | **string** | | [default to undefined]
9
+ **parentFilterId** | **string** | | [default to undefined]
10
+ **operator** | [**AnnouncementAudienceOperator**](AnnouncementAudienceOperator.md) | | [default to undefined]
11
+ **sortOrder** | **number** | | [default to undefined]
12
+ **conditions** | [**Array<AnnouncementAudienceCondition>**](AnnouncementAudienceCondition.md) | | [default to undefined]
13
+ **createdAt** | **string** | | [default to undefined]
14
+ **updatedAt** | **string** | | [default to undefined]
15
+
16
+ ## Example
17
+
18
+ ```typescript
19
+ import { AnnouncementAudienceFilter } from '@connectedxm/admin-sdk';
20
+
21
+ const instance: AnnouncementAudienceFilter = {
22
+ id,
23
+ parentFilterId,
24
+ operator,
25
+ sortOrder,
26
+ conditions,
27
+ createdAt,
28
+ updatedAt,
29
+ };
30
+ ```
31
+
32
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,24 @@
1
+ # AnnouncementAudienceFilterCreateInputs
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **parentFilterId** | **string** | | [optional] [default to undefined]
9
+ **operator** | [**AnnouncementAudienceOperator**](AnnouncementAudienceOperator.md) | | [optional] [default to undefined]
10
+ **sortOrder** | **number** | | [optional] [default to undefined]
11
+
12
+ ## Example
13
+
14
+ ```typescript
15
+ import { AnnouncementAudienceFilterCreateInputs } from '@connectedxm/admin-sdk';
16
+
17
+ const instance: AnnouncementAudienceFilterCreateInputs = {
18
+ parentFilterId,
19
+ operator,
20
+ sortOrder,
21
+ };
22
+ ```
23
+
24
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,22 @@
1
+ # AnnouncementAudienceFilterUpdateInputs
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **operator** | [**AnnouncementAudienceOperator**](AnnouncementAudienceOperator.md) | | [optional] [default to undefined]
9
+ **sortOrder** | **number** | | [optional] [default to undefined]
10
+
11
+ ## Example
12
+
13
+ ```typescript
14
+ import { AnnouncementAudienceFilterUpdateInputs } from '@connectedxm/admin-sdk';
15
+
16
+ const instance: AnnouncementAudienceFilterUpdateInputs = {
17
+ operator,
18
+ sortOrder,
19
+ };
20
+ ```
21
+
22
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,10 @@
1
+ # AnnouncementAudienceOperator
2
+
3
+
4
+ ## Enum
5
+
6
+ * `And` (value: `'AND'`)
7
+
8
+ * `Or` (value: `'OR'`)
9
+
10
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,26 @@
1
+ # AnnouncementAudienceReference
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **id** | **string** | | [default to undefined]
9
+ **name** | **string** | | [default to undefined]
10
+ **eventId** | **string** | | [default to undefined]
11
+ **groupId** | **string** | | [default to undefined]
12
+
13
+ ## Example
14
+
15
+ ```typescript
16
+ import { AnnouncementAudienceReference } from '@connectedxm/admin-sdk';
17
+
18
+ const instance: AnnouncementAudienceReference = {
19
+ id,
20
+ name,
21
+ eventId,
22
+ groupId,
23
+ };
24
+ ```
25
+
26
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,24 @@
1
+ # AnnouncementAudienceScope
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **eventId** | **string** | | [optional] [default to undefined]
9
+ **groupId** | **string** | | [optional] [default to undefined]
10
+ **channelId** | **string** | | [optional] [default to undefined]
11
+
12
+ ## Example
13
+
14
+ ```typescript
15
+ import { AnnouncementAudienceScope } from '@connectedxm/admin-sdk';
16
+
17
+ const instance: AnnouncementAudienceScope = {
18
+ eventId,
19
+ groupId,
20
+ channelId,
21
+ };
22
+ ```
23
+
24
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,24 @@
1
+ # AnnouncementAudienceUpdateInputs
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **name** | **string** | | [optional] [default to undefined]
9
+ **description** | **string** | | [optional] [default to undefined]
10
+ **operator** | [**AnnouncementAudienceOperator**](AnnouncementAudienceOperator.md) | | [optional] [default to undefined]
11
+
12
+ ## Example
13
+
14
+ ```typescript
15
+ import { AnnouncementAudienceUpdateInputs } from '@connectedxm/admin-sdk';
16
+
17
+ const instance: AnnouncementAudienceUpdateInputs = {
18
+ name,
19
+ description,
20
+ operator,
21
+ };
22
+ ```
23
+
24
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -5,20 +5,16 @@
5
5
 
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
- **title** | **string** | | [default to undefined]
8
+ **title** | **string** | | [optional] [default to undefined]
9
9
  **html** | **string** | | [optional] [default to undefined]
10
+ **templateId** | **string** | | [optional] [default to undefined]
10
11
  **slug** | **string** | | [optional] [default to undefined]
11
12
  **creatorId** | **string** | | [optional] [default to undefined]
12
13
  **eventId** | **string** | | [optional] [default to undefined]
13
14
  **groupId** | **string** | | [optional] [default to undefined]
14
- **tierId** | **string** | | [optional] [default to undefined]
15
- **channelId** | **string** | | [optional] [default to undefined]
16
- **accountId** | **string** | | [optional] [default to undefined]
17
- **verifiedAccounts** | **boolean** | | [optional] [default to undefined]
18
- **sponsorshipLevelId** | **string** | | [optional] [default to undefined]
15
+ **audienceId** | **string** | | [optional] [default to undefined]
19
16
  **email** | **boolean** | | [optional] [default to undefined]
20
17
  **push** | **boolean** | | [optional] [default to undefined]
21
- **filters** | [**EventAnnouncementFilters**](EventAnnouncementFilters.md) | | [optional] [default to undefined]
22
18
  **includePasses** | **boolean** | | [optional] [default to undefined]
23
19
 
24
20
  ## Example
@@ -29,18 +25,14 @@ import { AnnouncementCreateInputs } from '@connectedxm/admin-sdk';
29
25
  const instance: AnnouncementCreateInputs = {
30
26
  title,
31
27
  html,
28
+ templateId,
32
29
  slug,
33
30
  creatorId,
34
31
  eventId,
35
32
  groupId,
36
- tierId,
37
- channelId,
38
- accountId,
39
- verifiedAccounts,
40
- sponsorshipLevelId,
33
+ audienceId,
41
34
  email,
42
35
  push,
43
- filters,
44
36
  includePasses,
45
37
  };
46
38
  ```
@@ -5,13 +5,10 @@
5
5
 
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
- **verifiedAccounts** | **boolean** | | [optional] [default to undefined]
9
8
  **eventId** | **string** | | [optional] [default to undefined]
10
9
  **groupId** | **string** | | [optional] [default to undefined]
11
- **tierId** | **string** | | [optional] [default to undefined]
12
- **channelId** | **string** | | [optional] [default to undefined]
13
- **accountId** | **string** | | [optional] [default to undefined]
14
- **sponsorshipLevelId** | **string** | | [optional] [default to undefined]
10
+ **audienceId** | **string** | | [optional] [default to undefined]
11
+ **community** | **boolean** | | [optional] [default to undefined]
15
12
 
16
13
  ## Example
17
14
 
@@ -19,13 +16,10 @@ Name | Type | Description | Notes
19
16
  import { AnnouncementFilters } from '@connectedxm/admin-sdk';
20
17
 
21
18
  const instance: AnnouncementFilters = {
22
- verifiedAccounts,
23
19
  eventId,
24
20
  groupId,
25
- tierId,
26
- channelId,
27
- accountId,
28
- sponsorshipLevelId,
21
+ audienceId,
22
+ community,
29
23
  };
30
24
  ```
31
25
 
@@ -0,0 +1,24 @@
1
+ # AnnouncementMergeField
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **token** | **string** | | [default to undefined]
9
+ **label** | **string** | | [default to undefined]
10
+ **group** | **string** | | [default to undefined]
11
+
12
+ ## Example
13
+
14
+ ```typescript
15
+ import { AnnouncementMergeField } from '@connectedxm/admin-sdk';
16
+
17
+ const instance: AnnouncementMergeField = {
18
+ token,
19
+ label,
20
+ group,
21
+ };
22
+ ```
23
+
24
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,32 @@
1
+ # AnnouncementTemplate
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **id** | **string** | | [default to undefined]
9
+ **name** | **string** | | [default to undefined]
10
+ **description** | **string** | | [default to undefined]
11
+ **title** | **string** | | [default to undefined]
12
+ **html** | **string** | | [default to undefined]
13
+ **createdAt** | **string** | | [default to undefined]
14
+ **updatedAt** | **string** | | [default to undefined]
15
+
16
+ ## Example
17
+
18
+ ```typescript
19
+ import { AnnouncementTemplate } from '@connectedxm/admin-sdk';
20
+
21
+ const instance: AnnouncementTemplate = {
22
+ id,
23
+ name,
24
+ description,
25
+ title,
26
+ html,
27
+ createdAt,
28
+ updatedAt,
29
+ };
30
+ ```
31
+
32
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,26 @@
1
+ # AnnouncementTemplateCreateInputs
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **name** | **string** | | [default to undefined]
9
+ **description** | **string** | | [optional] [default to undefined]
10
+ **title** | **string** | | [optional] [default to undefined]
11
+ **html** | **string** | | [optional] [default to undefined]
12
+
13
+ ## Example
14
+
15
+ ```typescript
16
+ import { AnnouncementTemplateCreateInputs } from '@connectedxm/admin-sdk';
17
+
18
+ const instance: AnnouncementTemplateCreateInputs = {
19
+ name,
20
+ description,
21
+ title,
22
+ html,
23
+ };
24
+ ```
25
+
26
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,30 @@
1
+ # AnnouncementTemplateTranslation
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **id** | **string** | | [default to undefined]
9
+ **locale** | **string** | | [default to undefined]
10
+ **title** | **string** | | [default to undefined]
11
+ **html** | **string** | | [default to undefined]
12
+ **createdAt** | **string** | | [default to undefined]
13
+ **updatedAt** | **string** | | [default to undefined]
14
+
15
+ ## Example
16
+
17
+ ```typescript
18
+ import { AnnouncementTemplateTranslation } from '@connectedxm/admin-sdk';
19
+
20
+ const instance: AnnouncementTemplateTranslation = {
21
+ id,
22
+ locale,
23
+ title,
24
+ html,
25
+ createdAt,
26
+ updatedAt,
27
+ };
28
+ ```
29
+
30
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,22 @@
1
+ # AnnouncementTemplateTranslationUpdateInputs
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **title** | **string** | | [optional] [default to undefined]
9
+ **html** | **string** | | [optional] [default to undefined]
10
+
11
+ ## Example
12
+
13
+ ```typescript
14
+ import { AnnouncementTemplateTranslationUpdateInputs } from '@connectedxm/admin-sdk';
15
+
16
+ const instance: AnnouncementTemplateTranslationUpdateInputs = {
17
+ title,
18
+ html,
19
+ };
20
+ ```
21
+
22
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,26 @@
1
+ # AnnouncementTemplateUpdateInputs
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **name** | **string** | | [optional] [default to undefined]
9
+ **description** | **string** | | [optional] [default to undefined]
10
+ **title** | **string** | | [optional] [default to undefined]
11
+ **html** | **string** | | [optional] [default to undefined]
12
+
13
+ ## Example
14
+
15
+ ```typescript
16
+ import { AnnouncementTemplateUpdateInputs } from '@connectedxm/admin-sdk';
17
+
18
+ const instance: AnnouncementTemplateUpdateInputs = {
19
+ name,
20
+ description,
21
+ title,
22
+ html,
23
+ };
24
+ ```
25
+
26
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -8,9 +8,9 @@ Name | Type | Description | Notes
8
8
  **title** | **string** | | [optional] [default to undefined]
9
9
  **html** | **string** | | [optional] [default to undefined]
10
10
  **slug** | **string** | | [optional] [default to undefined]
11
+ **audienceId** | **string** | | [optional] [default to undefined]
11
12
  **email** | **boolean** | | [optional] [default to undefined]
12
13
  **push** | **boolean** | | [optional] [default to undefined]
13
- **filters** | [**EventAnnouncementFilters**](EventAnnouncementFilters.md) | | [optional] [default to undefined]
14
14
  **includePasses** | **boolean** | | [optional] [default to undefined]
15
15
 
16
16
  ## Example
@@ -22,9 +22,9 @@ const instance: AnnouncementUpdateInputs = {
22
22
  title,
23
23
  html,
24
24
  slug,
25
+ audienceId,
25
26
  email,
26
27
  push,
27
- filters,
28
28
  includePasses,
29
29
  };
30
30
  ```
@@ -7,8 +7,9 @@ All URIs are relative to *https://admin-api.connected.dev*
7
7
  |[**createAnnouncement**](#createannouncement) | **POST** /announcements | Create an announcement|
8
8
  |[**deleteAnnouncement**](#deleteannouncement) | **DELETE** /announcements/{announcementId} | Delete an announcement|
9
9
  |[**getAnnouncement**](#getannouncement) | **GET** /announcements/{announcementId} | Get an announcement|
10
- |[**getAnnouncementAudience**](#getannouncementaudience) | **GET** /announcements/{announcementId}/audience | List an announcement\'s target audience|
11
10
  |[**getAnnouncementEmailReceipts**](#getannouncementemailreceipts) | **GET** /announcements/{announcementId}/email-receipts | List an announcement\'s email delivery receipts|
11
+ |[**getAnnouncementMergeFields**](#getannouncementmergefields) | **GET** /announcements/merge-fields | List announcement merge fields|
12
+ |[**getAnnouncementRecipients**](#getannouncementrecipients) | **GET** /announcements/{announcementId}/audience | List an announcement\'s recipients|
12
13
  |[**getAnnouncements**](#getannouncements) | **GET** /announcements | List announcements|
13
14
  |[**sendAnnouncementPreview**](#sendannouncementpreview) | **POST** /announcements/{announcementId}/preview | Send a preview of an announcement|
14
15
  |[**updateAnnouncement**](#updateannouncement) | **PUT** /announcements/{announcementId} | Update an announcement|
@@ -16,7 +17,7 @@ All URIs are relative to *https://admin-api.connected.dev*
16
17
  # **createAnnouncement**
17
18
  > CreateAnnouncement200Response createAnnouncement(announcementCreateInputs)
18
19
 
19
- Creates a new announcement for the organization, requiring at least one audience target (event, group, tier, channel, account, or verified accounts) and requiring create permission on announcements; admins cannot assign the creator directly.
20
+ Creates an announcement in the community, an event (eventId) or a group (groupId), optionally narrowed by an audience in the same scope. Pass templateId to start from a template: its subject, HTML body and translations are copied in once, filling anything the request leaves out, and later template edits don\'t affect the announcement. Requires create permission on announcements.
20
21
 
21
22
  ### Example
22
23
 
@@ -167,10 +168,10 @@ const { status, data } = await apiInstance.getAnnouncement(
167
168
 
168
169
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
169
170
 
170
- # **getAnnouncementAudience**
171
- > GetAnnouncementAudience200Response getAnnouncementAudience()
171
+ # **getAnnouncementEmailReceipts**
172
+ > GetAcccountEmailReceipts200Response getAnnouncementEmailReceipts()
172
173
 
173
- Returns a paginated list of the accounts that an announcement was or will be sent to, supporting search and ordering; requires read permission on announcements.
174
+ Returns a paginated list of email receipts recording delivery status for the given announcement, optionally filtered by delivery status, with search and ordering support; requires read permission on both announcements and logs.
174
175
 
175
176
  ### Example
176
177
 
@@ -184,13 +185,15 @@ const configuration = new Configuration();
184
185
  const apiInstance = new AnnouncementsApi(configuration);
185
186
 
186
187
  let announcementId: string; //The announcement identifier (default to undefined)
188
+ let status: EmailReceiptStatus; //Filter by status (optional) (default to undefined)
187
189
  let page: number; //Page number (optional) (default to 1)
188
190
  let pageSize: number; //Number of items per page (optional) (default to 25)
189
191
  let orderBy: string; //Field to order by (optional) (default to undefined)
190
192
  let search: string; //Search query (optional) (default to undefined)
191
193
 
192
- const { status, data } = await apiInstance.getAnnouncementAudience(
194
+ const { status, data } = await apiInstance.getAnnouncementEmailReceipts(
193
195
  announcementId,
196
+ status,
194
197
  page,
195
198
  pageSize,
196
199
  orderBy,
@@ -203,6 +206,7 @@ const { status, data } = await apiInstance.getAnnouncementAudience(
203
206
  |Name | Type | Description | Notes|
204
207
  |------------- | ------------- | ------------- | -------------|
205
208
  | **announcementId** | [**string**] | The announcement identifier | defaults to undefined|
209
+ | **status** | **EmailReceiptStatus** | Filter by status | (optional) defaults to undefined|
206
210
  | **page** | [**number**] | Page number | (optional) defaults to 1|
207
211
  | **pageSize** | [**number**] | Number of items per page | (optional) defaults to 25|
208
212
  | **orderBy** | [**string**] | Field to order by | (optional) defaults to undefined|
@@ -211,7 +215,7 @@ const { status, data } = await apiInstance.getAnnouncementAudience(
211
215
 
212
216
  ### Return type
213
217
 
214
- **GetAnnouncementAudience200Response**
218
+ **GetAcccountEmailReceipts200Response**
215
219
 
216
220
  ### Authorization
217
221
 
@@ -230,10 +234,54 @@ const { status, data } = await apiInstance.getAnnouncementAudience(
230
234
 
231
235
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
232
236
 
233
- # **getAnnouncementEmailReceipts**
234
- > GetAcccountEmailReceipts200Response getAnnouncementEmailReceipts()
237
+ # **getAnnouncementMergeFields**
238
+ > GetAnnouncementMergeFields200Response getAnnouncementMergeFields()
235
239
 
236
- Returns a paginated list of email receipts recording delivery status for the given announcement, optionally filtered by delivery status, with search and ordering support; requires read permission on both announcements and logs.
240
+ Returns the merge fields an announcement can use: the core account fields plus every account attribute that isn\'t admin-only, ordered by attribute sort order; requires read permission on announcements.
241
+
242
+ ### Example
243
+
244
+ ```typescript
245
+ import {
246
+ AnnouncementsApi,
247
+ Configuration
248
+ } from '@connectedxm/admin-sdk';
249
+
250
+ const configuration = new Configuration();
251
+ const apiInstance = new AnnouncementsApi(configuration);
252
+
253
+ const { status, data } = await apiInstance.getAnnouncementMergeFields();
254
+ ```
255
+
256
+ ### Parameters
257
+ This endpoint does not have any parameters.
258
+
259
+
260
+ ### Return type
261
+
262
+ **GetAnnouncementMergeFields200Response**
263
+
264
+ ### Authorization
265
+
266
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [OrganizationId](../README.md#OrganizationId)
267
+
268
+ ### HTTP request headers
269
+
270
+ - **Content-Type**: Not defined
271
+ - **Accept**: application/json
272
+
273
+
274
+ ### HTTP response details
275
+ | Status code | Description | Response headers |
276
+ |-------------|-------------|------------------|
277
+ |**200** | Successful response | - |
278
+
279
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
280
+
281
+ # **getAnnouncementRecipients**
282
+ > GetAnnouncementAudienceAccounts200Response getAnnouncementRecipients()
283
+
284
+ Returns a paginated list of the accounts an announcement reaches: its audience when it has one, otherwise everyone in its event, group or community, excluding banned accounts; supports search and ordering; requires read permission on announcements.
237
285
 
238
286
  ### Example
239
287
 
@@ -247,15 +295,13 @@ const configuration = new Configuration();
247
295
  const apiInstance = new AnnouncementsApi(configuration);
248
296
 
249
297
  let announcementId: string; //The announcement identifier (default to undefined)
250
- let status: EmailReceiptStatus; //Filter by status (optional) (default to undefined)
251
298
  let page: number; //Page number (optional) (default to 1)
252
299
  let pageSize: number; //Number of items per page (optional) (default to 25)
253
300
  let orderBy: string; //Field to order by (optional) (default to undefined)
254
301
  let search: string; //Search query (optional) (default to undefined)
255
302
 
256
- const { status, data } = await apiInstance.getAnnouncementEmailReceipts(
303
+ const { status, data } = await apiInstance.getAnnouncementRecipients(
257
304
  announcementId,
258
- status,
259
305
  page,
260
306
  pageSize,
261
307
  orderBy,
@@ -268,7 +314,6 @@ const { status, data } = await apiInstance.getAnnouncementEmailReceipts(
268
314
  |Name | Type | Description | Notes|
269
315
  |------------- | ------------- | ------------- | -------------|
270
316
  | **announcementId** | [**string**] | The announcement identifier | defaults to undefined|
271
- | **status** | **EmailReceiptStatus** | Filter by status | (optional) defaults to undefined|
272
317
  | **page** | [**number**] | Page number | (optional) defaults to 1|
273
318
  | **pageSize** | [**number**] | Number of items per page | (optional) defaults to 25|
274
319
  | **orderBy** | [**string**] | Field to order by | (optional) defaults to undefined|
@@ -277,7 +322,7 @@ const { status, data } = await apiInstance.getAnnouncementEmailReceipts(
277
322
 
278
323
  ### Return type
279
324
 
280
- **GetAcccountEmailReceipts200Response**
325
+ **GetAnnouncementAudienceAccounts200Response**
281
326
 
282
327
  ### Authorization
283
328
 
@@ -299,7 +344,7 @@ const { status, data } = await apiInstance.getAnnouncementEmailReceipts(
299
344
  # **getAnnouncements**
300
345
  > GetAnnouncements200Response getAnnouncements()
301
346
 
302
- Returns a paginated list of announcements for the organization, optionally filtered by event, group, tier, channel, account, sponsorship level, or verified-account status, with search and ordering support; requires read permission on announcements.
347
+ Returns a paginated list of announcements for the organization, optionally filtered to one event, one group, community announcements only, or those using one audience, with search and ordering support; requires read permission on announcements.
303
348
 
304
349
  ### Example
305
350
 
@@ -363,23 +408,26 @@ const { status, data } = await apiInstance.getAnnouncements(
363
408
  # **sendAnnouncementPreview**
364
409
  > CreateAccountInvitations200Response sendAnnouncementPreview()
365
410
 
366
- Queues a preview send of the announcement\'s current content to a test recipient (identified by userId or accountId in the announcement), failing if the announcement has no HTML content yet; requires create permission on announcements.
411
+ Emails a preview of the announcement to the signed-in admin. Pass accountId to fill in merge fields as that account would see them; the preview still goes to the admin, never to the account. Fails if the announcement has no HTML content yet; requires create permission on announcements.
367
412
 
368
413
  ### Example
369
414
 
370
415
  ```typescript
371
416
  import {
372
417
  AnnouncementsApi,
373
- Configuration
418
+ Configuration,
419
+ SendAnnouncementPreviewRequest
374
420
  } from '@connectedxm/admin-sdk';
375
421
 
376
422
  const configuration = new Configuration();
377
423
  const apiInstance = new AnnouncementsApi(configuration);
378
424
 
379
425
  let announcementId: string; //The announcement identifier (default to undefined)
426
+ let sendAnnouncementPreviewRequest: SendAnnouncementPreviewRequest; // (optional)
380
427
 
381
428
  const { status, data } = await apiInstance.sendAnnouncementPreview(
382
- announcementId
429
+ announcementId,
430
+ sendAnnouncementPreviewRequest
383
431
  );
384
432
  ```
385
433
 
@@ -387,6 +435,7 @@ const { status, data } = await apiInstance.sendAnnouncementPreview(
387
435
 
388
436
  |Name | Type | Description | Notes|
389
437
  |------------- | ------------- | ------------- | -------------|
438
+ | **sendAnnouncementPreviewRequest** | **SendAnnouncementPreviewRequest**| | |
390
439
  | **announcementId** | [**string**] | The announcement identifier | defaults to undefined|
391
440
 
392
441
 
@@ -400,7 +449,7 @@ const { status, data } = await apiInstance.sendAnnouncementPreview(
400
449
 
401
450
  ### HTTP request headers
402
451
 
403
- - **Content-Type**: Not defined
452
+ - **Content-Type**: application/json
404
453
  - **Accept**: application/json
405
454
 
406
455