@wix/auto_sdk_email-marketing_campaigns 1.0.4 → 1.0.6

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 (73) hide show
  1. package/build/cjs/src/email-marketing-v1-campaign-campaigns.context.d.ts +5 -5
  2. package/build/cjs/src/email-marketing-v1-campaign-campaigns.context.js +4 -4
  3. package/build/cjs/src/email-marketing-v1-campaign-campaigns.context.js.map +1 -1
  4. package/build/cjs/src/email-marketing-v1-campaign-campaigns.http.d.ts +22 -22
  5. package/build/cjs/src/email-marketing-v1-campaign-campaigns.http.js +72 -192
  6. package/build/cjs/src/email-marketing-v1-campaign-campaigns.http.js.map +1 -1
  7. package/build/cjs/src/email-marketing-v1-campaign-campaigns.meta.d.ts +4 -4
  8. package/build/cjs/src/email-marketing-v1-campaign-campaigns.meta.js +39 -39
  9. package/build/cjs/src/email-marketing-v1-campaign-campaigns.meta.js.map +1 -1
  10. package/build/cjs/src/email-marketing-v1-campaign-campaigns.public.d.ts +38 -38
  11. package/build/cjs/src/email-marketing-v1-campaign-campaigns.public.js +13 -13
  12. package/build/cjs/src/email-marketing-v1-campaign-campaigns.public.js.map +1 -1
  13. package/build/cjs/src/email-marketing-v1-campaign-campaigns.types.d.ts +653 -322
  14. package/build/cjs/src/email-marketing-v1-campaign-campaigns.types.js +12 -12
  15. package/build/cjs/src/email-marketing-v1-campaign-campaigns.types.js.map +1 -1
  16. package/build/cjs/src/email-marketing-v1-campaign-campaigns.universal.d.ts +851 -464
  17. package/build/cjs/src/email-marketing-v1-campaign-campaigns.universal.js +146 -120
  18. package/build/cjs/src/email-marketing-v1-campaign-campaigns.universal.js.map +1 -1
  19. package/build/es/src/email-marketing-v1-campaign-campaigns.context.d.ts +5 -5
  20. package/build/es/src/email-marketing-v1-campaign-campaigns.context.js +4 -4
  21. package/build/es/src/email-marketing-v1-campaign-campaigns.context.js.map +1 -1
  22. package/build/es/src/email-marketing-v1-campaign-campaigns.http.d.ts +22 -22
  23. package/build/es/src/email-marketing-v1-campaign-campaigns.http.js +69 -189
  24. package/build/es/src/email-marketing-v1-campaign-campaigns.http.js.map +1 -1
  25. package/build/es/src/email-marketing-v1-campaign-campaigns.meta.d.ts +4 -4
  26. package/build/es/src/email-marketing-v1-campaign-campaigns.meta.js +36 -36
  27. package/build/es/src/email-marketing-v1-campaign-campaigns.meta.js.map +1 -1
  28. package/build/es/src/email-marketing-v1-campaign-campaigns.public.d.ts +38 -38
  29. package/build/es/src/email-marketing-v1-campaign-campaigns.public.js +10 -10
  30. package/build/es/src/email-marketing-v1-campaign-campaigns.public.js.map +1 -1
  31. package/build/es/src/email-marketing-v1-campaign-campaigns.types.d.ts +653 -322
  32. package/build/es/src/email-marketing-v1-campaign-campaigns.types.js +11 -11
  33. package/build/es/src/email-marketing-v1-campaign-campaigns.types.js.map +1 -1
  34. package/build/es/src/email-marketing-v1-campaign-campaigns.universal.d.ts +851 -464
  35. package/build/es/src/email-marketing-v1-campaign-campaigns.universal.js +143 -117
  36. package/build/es/src/email-marketing-v1-campaign-campaigns.universal.js.map +1 -1
  37. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.context.d.ts +5 -5
  38. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.context.js +4 -4
  39. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.context.js.map +1 -1
  40. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.http.d.ts +22 -22
  41. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.http.js +72 -192
  42. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.http.js.map +1 -1
  43. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.meta.d.ts +4 -4
  44. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.meta.js +39 -39
  45. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.meta.js.map +1 -1
  46. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.public.d.ts +38 -38
  47. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.public.js +13 -13
  48. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.public.js.map +1 -1
  49. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.types.d.ts +653 -322
  50. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.types.js +12 -12
  51. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.types.js.map +1 -1
  52. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.universal.d.ts +851 -464
  53. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.universal.js +146 -120
  54. package/build/internal/cjs/src/email-marketing-v1-campaign-campaigns.universal.js.map +1 -1
  55. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.context.d.ts +5 -5
  56. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.context.js +4 -4
  57. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.context.js.map +1 -1
  58. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.http.d.ts +22 -22
  59. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.http.js +69 -189
  60. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.http.js.map +1 -1
  61. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.meta.d.ts +4 -4
  62. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.meta.js +36 -36
  63. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.meta.js.map +1 -1
  64. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.public.d.ts +38 -38
  65. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.public.js +10 -10
  66. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.public.js.map +1 -1
  67. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.types.d.ts +653 -322
  68. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.types.js +11 -11
  69. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.types.js.map +1 -1
  70. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.universal.d.ts +851 -464
  71. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.universal.js +143 -117
  72. package/build/internal/es/src/email-marketing-v1-campaign-campaigns.universal.js.map +1 -1
  73. package/package.json +2 -2
@@ -1,14 +1,21 @@
1
1
  export interface Campaign {
2
- /** Campaign ID. */
2
+ /**
3
+ * Campaign ID.
4
+ * @format GUID
5
+ */
3
6
  campaignId?: string;
4
7
  /** Marketing campaign title. If you don't provide the value, the title automatically gets the value of an email subject. */
5
8
  title?: string | null;
6
- /** URL of the first image after the logo. */
9
+ /**
10
+ * URL of the first image after the logo.
11
+ * @format WEB_URL
12
+ */
7
13
  firstImageUrl?: string | null;
8
14
  /**
9
15
  * Landing page snapshot URL. <br>
10
16
  * This field is deprecated and snapshot images are no longer supported. Instead, use the `firstImageUrl` field.
11
17
  * The value of this field will soon become the same as the value of the `firstImageUrl` field.
18
+ * @format WEB_URL
12
19
  * @deprecated Landing page snapshot URL. <br>
13
20
  * This field is deprecated and snapshot images are no longer supported. Instead, use the `firstImageUrl` field.
14
21
  * The value of this field will soon become the same as the value of the `firstImageUrl` field.
@@ -59,6 +66,7 @@ export interface Campaign {
59
66
  /**
60
67
  * Email subject of the campaign (initially copied from the template).
61
68
  * TODO: Deprecated (moved to "GetComposerResponse").
69
+ * @maxLength 1000
62
70
  * @deprecated
63
71
  */
64
72
  emailSubject?: string;
@@ -118,7 +126,10 @@ export declare enum Enum {
118
126
  PAUSED = "PAUSED"
119
127
  }
120
128
  export interface PublishingData {
121
- /** Landing page URL. */
129
+ /**
130
+ * Landing page URL.
131
+ * @format WEB_URL
132
+ */
122
133
  landingPageUrl?: string;
123
134
  /** Marketing campaign statistics. */
124
135
  statistics?: CampaignStatistics;
@@ -224,12 +235,187 @@ export declare enum CampaignTypeEnum {
224
235
  /** triggered email */
225
236
  TRIGGERED = "TRIGGERED"
226
237
  }
238
+ export interface ValidateLinkRequest {
239
+ /**
240
+ * URL to validate.
241
+ * @minLength 1
242
+ */
243
+ url: string;
244
+ }
245
+ export interface ValidateLinkResponse {
246
+ /** Whether the link is valid. */
247
+ valid?: boolean;
248
+ }
249
+ export interface ValidateHtmlLinksRequest {
250
+ /**
251
+ * HTML string with links.
252
+ * @maxLength 1000000
253
+ */
254
+ html: string;
255
+ }
256
+ export interface ValidateHtmlLinksResponse {
257
+ /** Non-valid links. */
258
+ blacklistedLinks?: string[];
259
+ }
260
+ export interface GetCampaignMappingRequest {
261
+ /**
262
+ * rule ID in automations
263
+ * @format GUID
264
+ */
265
+ automationRuleId?: string;
266
+ /**
267
+ * template ID configured for the automation
268
+ * @format GUID
269
+ */
270
+ templateId?: string;
271
+ }
272
+ export interface GetCampaignMappingResponse {
273
+ /** @format GUID */
274
+ campaignId?: string;
275
+ }
276
+ export interface UpsertTranslationRequest {
277
+ /**
278
+ * Campaign ID.
279
+ * @format GUID
280
+ */
281
+ campaignId?: string;
282
+ /** Composer data. */
283
+ composer?: Composer;
284
+ /**
285
+ * Translation language (optional, default value "EN").
286
+ * @format LANGUAGE
287
+ */
288
+ language?: string | null;
289
+ /**
290
+ * For BI event [36:1031] only (optional, default value "n/a").
291
+ * @format GUID
292
+ */
293
+ automationRuleId?: string | null;
294
+ /** Should campaign also be published or not (default value "false"). */
295
+ publish?: boolean;
296
+ /**
297
+ * Campaign subject (optional).
298
+ * @maxLength 1000
299
+ */
300
+ emailSubject?: string | null;
301
+ /**
302
+ * Campaign preheader (optional).
303
+ * @maxLength 1000
304
+ */
305
+ emailPreheader?: string | null;
306
+ }
307
+ export interface Composer {
308
+ /**
309
+ * Internal data structure for editor/viewer to render the campaign.
310
+ * @maxLength 10000000
311
+ */
312
+ composerDataJson?: string;
313
+ /** Default values of existing placeholders. */
314
+ defaultValues?: DefaultValues;
315
+ }
316
+ export interface DefaultValues {
317
+ /** @maxSize 500 */
318
+ map?: Record<string, string>;
319
+ }
320
+ export interface UpsertTranslationResponse {
321
+ }
322
+ export interface GetUsedPlaceholderKeysRequest {
323
+ /**
324
+ * Campaign ID.
325
+ * @format GUID
326
+ */
327
+ campaignId?: string;
328
+ }
329
+ export interface GetUsedPlaceholderKeysResponse {
330
+ /**
331
+ * Keys of placeholders used in the automation.
332
+ * @maxLength 200
333
+ * @maxSize 300
334
+ */
335
+ placeholderKeys?: string[];
336
+ }
337
+ export interface LookupCampaignMappingRequest {
338
+ /**
339
+ * rule ID in automations
340
+ * @format GUID
341
+ */
342
+ automationRuleId?: string;
343
+ /**
344
+ * template ID configured for the automation
345
+ * @format GUID
346
+ */
347
+ templateId?: string;
348
+ }
349
+ export interface LookupCampaignMappingResponse {
350
+ /** @format GUID */
351
+ campaignId?: string | null;
352
+ }
353
+ export interface UpsertAutomationTranslatorContentRequest {
354
+ /**
355
+ * Campaign ID that the content belongs to
356
+ * @format GUID
357
+ */
358
+ campaignId?: string;
359
+ /** Automation translator content */
360
+ automationTranslatorContent?: AutomationTranslatorContent;
361
+ }
362
+ /** Automation Translator Content */
363
+ export interface AutomationTranslatorContent {
364
+ /**
365
+ * AutomationTranslatorContent ID
366
+ * @minLength 1
367
+ * @maxLength 256
368
+ * @immutable
369
+ */
370
+ _id?: string;
371
+ /**
372
+ * Content that can contain multiple strings. It represents a json file, that is stored on Smartling
373
+ * @minLength 1
374
+ * @maxLength 800000
375
+ */
376
+ json?: string;
377
+ }
378
+ export interface UpsertAutomationTranslatorContentResponse {
379
+ }
380
+ export interface GetAutomationTranslatorContentRequest {
381
+ /**
382
+ * Campaign ID
383
+ * @format GUID
384
+ */
385
+ campaignId?: string;
386
+ }
387
+ export interface GetAutomationTranslatorContentResponse {
388
+ /** Automation translator content */
389
+ automationTranslatorContent?: AutomationTranslatorContent;
390
+ }
391
+ export interface GetPlaceholderKeysRequest {
392
+ /**
393
+ * Campaign ID.
394
+ * @format GUID
395
+ */
396
+ campaignId?: string;
397
+ }
398
+ export interface GetPlaceholderKeysResponse {
399
+ /** Keys of placeholders used in the campaign. */
400
+ placeholderKeys?: string[];
401
+ }
402
+ export interface GetDefaultComponentsRequest {
403
+ }
404
+ export interface GetDefaultComponentsResponse {
405
+ footer?: Record<string, any> | null;
406
+ logo?: Record<string, any> | null;
407
+ follow?: Record<string, any> | null;
408
+ }
227
409
  export interface EstimateFilterSizeRequest {
228
410
  /** Contacts filter expression. */
229
411
  filter?: Record<string, any> | null;
230
412
  /** Should "inactive" contacts be excluded or not (default value "false"). */
231
413
  activeContactsOnly?: boolean;
232
- /** Contacts plain text search expression (searches in name, phone and email fields). */
414
+ /**
415
+ * Contacts plain text search expression (searches in name, phone and email fields).
416
+ * @minLength 1
417
+ * @maxLength 100
418
+ */
233
419
  search?: string | null;
234
420
  }
235
421
  export interface EstimateFilterSizeResponse {
@@ -237,19 +423,32 @@ export interface EstimateFilterSizeResponse {
237
423
  estimation?: number;
238
424
  }
239
425
  export interface EstimateAudienceSizeRequest {
240
- /** Contact IDs of a campaign audience. */
426
+ /**
427
+ * Contact IDs of a campaign audience.
428
+ * @format GUID
429
+ */
241
430
  contactIds?: string[];
242
431
  /** Label IDs of a campaign audience. */
243
432
  labelIds?: string[];
244
433
  /** Contacts filter expression (json). */
245
434
  contactsFilter?: Record<string, any> | null;
246
- /** Contacts plain text search expression (searches in name, phone and email fields). */
435
+ /**
436
+ * Contacts plain text search expression (searches in name, phone and email fields).
437
+ * @minLength 1
438
+ * @maxLength 100
439
+ */
247
440
  search?: string | null;
248
- /** Segment ids of a campaign audience. */
441
+ /**
442
+ * Segment ids of a campaign audience.
443
+ * @format GUID
444
+ */
249
445
  segmentIds?: string[];
250
446
  /** Should "inactive" contacts be excluded or not (default value "false"). */
251
447
  activeContactsOnly?: boolean;
252
- /** Id of a campaign that is to be resent. */
448
+ /**
449
+ * Id of a campaign that is to be resent.
450
+ * @format GUID
451
+ */
253
452
  resendCampaignId?: string | null;
254
453
  /** Should total number of contacts in provided audience be returned or not (default value "false"). */
255
454
  withTotal?: boolean;
@@ -261,7 +460,10 @@ export interface EstimateAudienceSizeResponse {
261
460
  total?: number | null;
262
461
  }
263
462
  export interface ReconcileContactRequest {
264
- /** Email address of the contact. */
463
+ /**
464
+ * Email address of the contact.
465
+ * @format EMAIL
466
+ */
265
467
  emailAddress?: string;
266
468
  }
267
469
  export interface ReconcileContactResponse {
@@ -269,21 +471,40 @@ export interface ReconcileContactResponse {
269
471
  contact?: Contact;
270
472
  }
271
473
  export interface Contact {
272
- /** Unique ID of the contact entity. */
474
+ /**
475
+ * Unique ID of the contact entity.
476
+ * @format GUID
477
+ */
273
478
  _id?: string;
274
- /** Primary email address of the contact. */
479
+ /**
480
+ * Primary email address of the contact.
481
+ * @format EMAIL
482
+ */
275
483
  emailAddress?: string;
276
- /** Full name of the contact (optional). */
484
+ /**
485
+ * Full name of the contact (optional).
486
+ * @maxLength 100
487
+ */
277
488
  fullName?: string | null;
278
- /** Profile picture of the contact (optional). */
489
+ /**
490
+ * Profile picture of the contact (optional).
491
+ * @format WEB_URL
492
+ * @maxLength 2048
493
+ */
279
494
  pictureUrl?: string | null;
280
495
  }
281
496
  export interface SearchContactsRequest {
282
- /** Text to search contacts by - can search by name or email address. */
497
+ /**
498
+ * Text to search contacts by - can search by name or email address.
499
+ * @maxLength 100
500
+ */
283
501
  searchTerm?: string;
284
502
  /** Should "inactive" contacts be excluded or not (default value "false"). */
285
503
  activeContactsOnly?: boolean;
286
- /** Page size (default 50, max 1000). */
504
+ /**
505
+ * Page size (default 50, max 1000).
506
+ * @max 1000
507
+ */
287
508
  pageSize?: number | null;
288
509
  }
289
510
  export interface SearchContactsResponse {
@@ -299,253 +520,42 @@ export interface GetLabelsResponse {
299
520
  labels?: Label[];
300
521
  }
301
522
  export interface Label {
302
- /** Unique ID of the label entity. */
523
+ /**
524
+ * Unique ID of the label entity.
525
+ * @maxLength 100
526
+ */
303
527
  _id?: string;
304
- /** Name of the label. */
528
+ /**
529
+ * Name of the label.
530
+ * @maxLength 100
531
+ */
305
532
  name?: string;
306
533
  /** Amount of contacts assigned to the label. */
307
534
  contactsCount?: number;
308
535
  }
309
536
  export interface SubscribeFromLandingPageRequest {
310
- /** Campaign ID that the subscription is happening from. */
537
+ /**
538
+ * Campaign ID that the subscription is happening from.
539
+ * @format GUID
540
+ */
311
541
  campaignId?: string;
312
- /** Email address that is entered into subscription field. */
542
+ /**
543
+ * Email address that is entered into subscription field.
544
+ * @format EMAIL
545
+ */
313
546
  emailAddress?: string;
314
547
  /** Did UoU explicitly consent to terms of use or not (optional, default value "false") */
315
548
  consent?: boolean;
316
549
  }
317
550
  export interface SubscribeFromLandingPageResponse {
551
+ /** @format GUID */
318
552
  contactId?: string;
319
553
  }
320
- export interface GetPlaceholderKeysRequest {
321
- /** Campaign ID. */
322
- campaignId?: string;
323
- }
324
- export interface GetPlaceholderKeysResponse {
325
- /** Keys of placeholders used in the campaign. */
326
- placeholderKeys?: string[];
327
- }
328
- export interface GetDefaultComponentsRequest {
329
- }
330
- export interface GetDefaultComponentsResponse {
331
- footer?: Record<string, any> | null;
332
- logo?: Record<string, any> | null;
333
- follow?: Record<string, any> | null;
334
- }
335
- export interface ValidateLinkRequest {
336
- /** URL to validate. */
337
- url: string;
338
- }
339
- export interface ValidateLinkResponse {
340
- /** Whether the link is valid. */
341
- valid?: boolean;
342
- }
343
- export interface ValidateHtmlLinksRequest {
344
- /** HTML string with links. */
345
- html: string;
346
- }
347
- export interface ValidateHtmlLinksResponse {
348
- /** Non-valid links. */
349
- blacklistedLinks?: string[];
350
- }
351
- export interface ListStatisticsRequest {
352
- /** IDs of the campaigns to retrieve (max 100 campaigns). */
353
- campaignIds: string[];
354
- }
355
- export interface ListStatisticsResponse {
356
- /** List of statistics. */
357
- statistics?: CampaignStatisticsContainer[];
358
- }
359
- export interface CampaignStatisticsContainer {
360
- /** Campaign ID. */
361
- campaignId?: string;
362
- /** Landing page statistics. */
363
- landingPage?: LandingPageStatistics;
364
- /** Email campaign statistics. */
365
- email?: DistributionStatistics;
366
- }
367
- export interface ListRecipientsRequest {
368
- /** Campaign ID. */
369
- campaignId: string;
370
- /**
371
- * __Required.__ Email activity to filter for. One of:
372
- * + `'DELIVERED'`
373
- * + `'OPENED'`
374
- * + `'CLICKED'`
375
- * + `'BOUNCED'`
376
- * + `'NOT_SENT'`
377
- */
378
- activity: RecipientsActivityEnum;
379
- /** Pagination options. */
380
- paging?: CursorPaging;
381
- }
382
- export declare enum RecipientsActivityEnum {
383
- UNKNOWN = "UNKNOWN",
384
- DELIVERED = "DELIVERED",
385
- OPENED = "OPENED",
386
- CLICKED = "CLICKED",
387
- BOUNCED = "BOUNCED",
388
- NOT_SENT = "NOT_SENT",
389
- SENT = "SENT",
390
- NOT_OPENED = "NOT_OPENED"
391
- }
392
- export interface CursorPaging {
393
- /** Number of items to load. */
394
- limit?: number | null;
554
+ export interface GetCampaignRequest {
395
555
  /**
396
- * Pointer to the next or previous page in the list of results.
397
- *
398
- * You can get the relevant cursor token
399
- * from the `pagingMetadata` object in the previous call's response.
400
- * Not relevant for the first request.
556
+ * Campaign ID.
557
+ * @format GUID
401
558
  */
402
- cursor?: string | null;
403
- }
404
- export interface ListRecipientsResponse {
405
- /** List of recipients. */
406
- recipients?: CampaignRecipientDetails[];
407
- /** Details on the paged set of returned results. */
408
- pagingMetadata?: PagingMetadataV2;
409
- }
410
- export interface CampaignRecipientDetails {
411
- /** Contact ID. */
412
- contactId?: string;
413
- /** Date and time of the last activity. */
414
- lastActivityDate?: Date | null;
415
- /** Primary email address of the contact. */
416
- emailAddress?: string;
417
- /** Full name of the contact (optional). */
418
- fullName?: string | null;
419
- /** Is this contact currently deleted from the site or not. */
420
- contactDeleted?: boolean;
421
- }
422
- export interface PagingMetadataV2 {
423
- /** Number of items returned in the response. */
424
- count?: number | null;
425
- /** Offset that was requested. */
426
- offset?: number | null;
427
- /** Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. */
428
- total?: number | null;
429
- /** Flag that indicates the server failed to calculate the `total` field. */
430
- tooManyToCount?: boolean | null;
431
- /** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
432
- cursors?: Cursors;
433
- }
434
- export interface Cursors {
435
- /** Cursor string pointing to the next page in the list of results. */
436
- next?: string | null;
437
- /** Cursor pointing to the previous page in the list of results. */
438
- prev?: string | null;
439
- }
440
- export interface GetCampaignMappingRequest {
441
- /** rule ID in automations */
442
- automationRuleId?: string;
443
- /** template ID configured for the automation */
444
- templateId?: string;
445
- }
446
- export interface GetCampaignMappingResponse {
447
- campaignId?: string;
448
- }
449
- export interface GetPingCampaignMappingRequest {
450
- /** ping stream ID. */
451
- streamId?: string;
452
- /** template ID configured for the ping automation. */
453
- templateId?: string;
454
- /** ID of the initiating vertical. */
455
- appDefId?: string;
456
- /** Ping template ID. */
457
- pingTemplateId?: string | null;
458
- /** Preferred language. */
459
- language?: string;
460
- /** rule ID in automations */
461
- automationRuleId?: string;
462
- }
463
- export interface GetPingCampaignMappingResponse {
464
- campaignId?: string;
465
- }
466
- export interface CampaignLookupRequest {
467
- campaignId?: string;
468
- }
469
- export interface CampaignLookupResponse {
470
- campaignId?: string;
471
- instanceId?: string;
472
- metasiteId?: string;
473
- }
474
- export interface CampaignLookupBatchRequest {
475
- campaignIds?: string[];
476
- }
477
- export interface CampaignLookupBatchResponse {
478
- responses?: CampaignLookupResponse[];
479
- }
480
- export interface UpsertTranslationRequest {
481
- /** Campaign ID. */
482
- campaignId?: string;
483
- /** Composer data. */
484
- composer?: Composer;
485
- /** Translation language (optional, default value "EN"). */
486
- language?: string | null;
487
- /** For BI event [36:1031] only (optional, default value "n/a"). */
488
- automationRuleId?: string | null;
489
- /** Should campaign also be published or not (default value "false"). */
490
- publish?: boolean;
491
- /** Campaign subject (optional). */
492
- emailSubject?: string | null;
493
- /** Campaign preheader (optional). */
494
- emailPreheader?: string | null;
495
- }
496
- export interface Composer {
497
- /** Internal data structure for editor/viewer to render the campaign. */
498
- composerDataJson?: string;
499
- /** Default values of existing placeholders. */
500
- defaultValues?: DefaultValues;
501
- }
502
- export interface DefaultValues {
503
- map?: Record<string, string>;
504
- }
505
- export interface UpsertTranslationResponse {
506
- }
507
- export interface GetUsedPlaceholderKeysRequest {
508
- /** Campaign ID. */
509
- campaignId?: string;
510
- }
511
- export interface GetUsedPlaceholderKeysResponse {
512
- /** Keys of placeholders used in the automation. */
513
- placeholderKeys?: string[];
514
- }
515
- export interface LookupCampaignMappingRequest {
516
- /** rule ID in automations */
517
- automationRuleId?: string;
518
- /** template ID configured for the automation */
519
- templateId?: string;
520
- }
521
- export interface LookupCampaignMappingResponse {
522
- campaignId?: string | null;
523
- }
524
- export interface UpsertAutomationTranslatorContentRequest {
525
- /** Campaign ID that the content belongs to */
526
- campaignId?: string;
527
- /** Automation translator content */
528
- automationTranslatorContent?: AutomationTranslatorContent;
529
- }
530
- /** Automation Translator Content */
531
- export interface AutomationTranslatorContent {
532
- /** AutomationTranslatorContent ID */
533
- _id?: string;
534
- /** Content that can contain multiple strings. It represents a json file, that is stored on Smartling */
535
- json?: string;
536
- }
537
- export interface UpsertAutomationTranslatorContentResponse {
538
- }
539
- export interface GetAutomationTranslatorContentRequest {
540
- /** Campaign ID */
541
- campaignId?: string;
542
- }
543
- export interface GetAutomationTranslatorContentResponse {
544
- /** Automation translator content */
545
- automationTranslatorContent?: AutomationTranslatorContent;
546
- }
547
- export interface GetCampaignRequest {
548
- /** Campaign ID. */
549
559
  campaignId: string;
550
560
  /**
551
561
  * Whether a returned campaign object should include `publishingData.statistics`.
@@ -611,7 +621,10 @@ export interface CountCampaignsResponse {
611
621
  archived?: number;
612
622
  }
613
623
  export interface CreateFromTemplateRequest {
614
- /** ID of the template to fork. */
624
+ /**
625
+ * ID of the template to fork.
626
+ * @format GUID
627
+ */
615
628
  templateId?: string;
616
629
  /** Values to replace template placeholders with (unique for each template). */
617
630
  variables?: Record<string, string>;
@@ -623,9 +636,15 @@ export interface CreateFromTemplateResponse {
623
636
  campaign?: Campaign;
624
637
  }
625
638
  export interface CreateUserTemplateRequest {
626
- /** ID of campaign to create template from. */
639
+ /**
640
+ * ID of campaign to create template from.
641
+ * @format GUID
642
+ */
627
643
  campaignId?: string;
628
- /** Title of template. */
644
+ /**
645
+ * Title of template.
646
+ * @maxLength 1000
647
+ */
629
648
  title?: string | null;
630
649
  }
631
650
  export interface CreateUserTemplateResponse {
@@ -633,7 +652,10 @@ export interface CreateUserTemplateResponse {
633
652
  campaign?: Campaign;
634
653
  }
635
654
  export interface CreateFromUserTemplateRequest {
636
- /** ID of the user template campaign to use. */
655
+ /**
656
+ * ID of the user template campaign to use.
657
+ * @format GUID
658
+ */
637
659
  campaignId?: string;
638
660
  }
639
661
  export interface CreateFromUserTemplateResponse {
@@ -641,20 +663,30 @@ export interface CreateFromUserTemplateResponse {
641
663
  campaign?: Campaign;
642
664
  }
643
665
  export interface PublishCampaignRequest {
644
- /** Campaign ID */
666
+ /**
667
+ * Campaign ID
668
+ * @format GUID
669
+ */
645
670
  campaignId: string;
646
671
  /** Email distribution options. Pass this object in the request if you need to distribute your marketing campaign with emails. */
647
672
  emailDistributionOptions?: EmailDistributionOptions;
648
673
  }
649
674
  export interface EmailDistributionOptions {
650
- /** The subject line for the email campaign, which appears in recipients’ inboxes. */
675
+ /**
676
+ * The subject line for the email campaign, which appears in recipients’ inboxes.
677
+ * @maxLength 1000
678
+ */
651
679
  emailSubject?: string | null;
652
680
  /** Contact label IDs. */
653
681
  labelIds?: string[];
654
- /** IDs of contacts to whom to send out the campaign. */
682
+ /**
683
+ * IDs of contacts to whom to send out the campaign.
684
+ * @format GUID
685
+ */
655
686
  contactIds?: string[];
656
687
  /**
657
688
  * Filter ids to send campaign to (unsupported).
689
+ * @format GUID
658
690
  * @deprecated Filter ids to send campaign to (unsupported).
659
691
  * @replacedBy contacts_filter
660
692
  * @targetRemovalDate 2023-10-10
@@ -668,23 +700,39 @@ export interface PublishCampaignResponse {
668
700
  publishingData?: PublishingData;
669
701
  }
670
702
  export interface Rejected {
671
- /** ID of the campaign that was rejected. */
703
+ /**
704
+ * ID of the campaign that was rejected.
705
+ * @format GUID
706
+ */
672
707
  campaignId?: string;
673
708
  }
674
709
  export interface Published {
675
- /** ID of the campaign that was published. */
710
+ /**
711
+ * ID of the campaign that was published.
712
+ * @format GUID
713
+ */
676
714
  campaignId?: string;
677
- /** Campaign landing page URL. */
715
+ /**
716
+ * Campaign landing page URL.
717
+ * @format WEB_URL
718
+ * @maxLength 2048
719
+ */
678
720
  landingPageUrl?: string;
679
721
  /** Estimation of recipient list size (optional). */
680
722
  mailingListSizeEstimate?: number | null;
681
723
  }
682
724
  export interface Terminated {
683
- /** ID of the campaign that was terminated. */
725
+ /**
726
+ * ID of the campaign that was terminated.
727
+ * @format GUID
728
+ */
684
729
  campaignId?: string;
685
730
  }
686
731
  export interface Distributed {
687
- /** ID of the campaign that was distributed. */
732
+ /**
733
+ * ID of the campaign that was distributed.
734
+ * @format GUID
735
+ */
688
736
  campaignId?: string;
689
737
  }
690
738
  export interface EmailActivityUpdated extends EmailActivityUpdatedEventTypeOneOf {
@@ -705,16 +753,28 @@ export interface EmailActivityUpdated extends EmailActivityUpdatedEventTypeOneOf
705
753
  * Indicates a permanent error sending your email. For example, the email address does not exist.
706
754
  */
707
755
  hardBounce?: HardBounce;
708
- /** Campaign ID. */
756
+ /**
757
+ * Campaign ID.
758
+ * @format GUID
759
+ */
709
760
  campaignId?: string;
710
- /** [Contact ID](https://dev.wix.com/api/rest/contacts/contacts/contacts-v4/contact-object) of a recipient. */
761
+ /**
762
+ * [Contact ID](https://dev.wix.com/api/rest/contacts/contacts/contacts-v4/contact-object) of a recipient.
763
+ * @format GUID
764
+ */
711
765
  contactId?: string;
712
- /** Email address of a recipient. */
766
+ /**
767
+ * Email address of a recipient.
768
+ * @format EMAIL
769
+ */
713
770
  recipientEmailAddress?: string;
714
771
  /** Date and time of the event. */
715
772
  timestamp?: Date | null;
716
773
  activityType?: ActivityType;
717
- /** email metadata */
774
+ /**
775
+ * email metadata
776
+ * @maxSize 20
777
+ */
718
778
  metadata?: Record<string, string>;
719
779
  }
720
780
  /** @oneof */
@@ -769,7 +829,10 @@ export interface HardBounce {
769
829
  reason?: string;
770
830
  }
771
831
  export interface Scheduled {
772
- /** ID of the campaign that was scheduled. */
832
+ /**
833
+ * ID of the campaign that was scheduled.
834
+ * @format GUID
835
+ */
773
836
  campaignId?: string;
774
837
  /** The timestamp campaign is scheduled for. */
775
838
  sendAt?: Date | null;
@@ -777,11 +840,20 @@ export interface Scheduled {
777
840
  rescheduled?: boolean;
778
841
  }
779
842
  export interface SendTestRequest {
780
- /** Campaign ID. */
843
+ /**
844
+ * Campaign ID.
845
+ * @format GUID
846
+ */
781
847
  campaignId: string;
782
- /** Email subject. */
848
+ /**
849
+ * Email subject.
850
+ * @maxLength 1000
851
+ */
783
852
  emailSubject?: string | null;
784
- /** Recipient email address. */
853
+ /**
854
+ * Recipient email address.
855
+ * @format EMAIL
856
+ */
785
857
  toEmailAddress: string;
786
858
  }
787
859
  export interface PlaceholderContent extends PlaceholderContentValueOneOf {
@@ -820,9 +892,15 @@ export interface Html {
820
892
  * Default format to use. Sufficiently compliant with majority of standards: w3c, ISO 4217, ISO 20022, ISO 8583:2003.
821
893
  */
822
894
  export interface Money {
823
- /** Monetary amount. Decimal string with a period as a decimal separator (e.g., 3.99). Optionally, a single (-), to indicate that the amount is negative. */
895
+ /**
896
+ * Monetary amount. Decimal string with a period as a decimal separator (e.g., 3.99). Optionally, a single (-), to indicate that the amount is negative.
897
+ * @format DECIMAL_VALUE
898
+ */
824
899
  value?: string;
825
- /** Currency code. Must be valid ISO 4217 currency code (e.g., USD). */
900
+ /**
901
+ * Currency code. Must be valid ISO 4217 currency code (e.g., USD).
902
+ * @format CURRENCY
903
+ */
826
904
  currency?: string;
827
905
  /** Monetary amount. Decimal string in local format (e.g., 1 000,30). Optionally, a single (-), to indicate that the amount is negative. */
828
906
  formattedValue?: string | null;
@@ -854,23 +932,33 @@ export interface Decimal {
854
932
  /**
855
933
  * when converted from Double, has a limitation of max 16 digits (including fractional part)
856
934
  * highest possible value for precise representation is 9999999999999998 (9999999999999999 is represented as 10000000000000000)
935
+ * @format DECIMAL_VALUE
857
936
  */
858
937
  value?: string;
859
938
  }
860
939
  export interface SendTestResponse {
861
940
  }
862
941
  export interface PauseSchedulingRequest {
863
- /** Campaign ID. */
942
+ /**
943
+ * Campaign ID.
944
+ * @format GUID
945
+ */
864
946
  campaignId: string;
865
947
  }
866
948
  export interface PauseSchedulingResponse {
867
949
  }
868
950
  export interface Paused {
869
- /** ID of the campaign that was paused. */
951
+ /**
952
+ * ID of the campaign that was paused.
953
+ * @format GUID
954
+ */
870
955
  campaignId?: string;
871
956
  }
872
957
  export interface RescheduleRequest {
873
- /** ID of the campaign to reschedule. */
958
+ /**
959
+ * ID of the campaign to reschedule.
960
+ * @format GUID
961
+ */
874
962
  campaignId: string;
875
963
  /** New time for sending out the campaign. */
876
964
  sendAt: Date | null;
@@ -878,43 +966,67 @@ export interface RescheduleRequest {
878
966
  export interface RescheduleResponse {
879
967
  }
880
968
  export interface ArchiveCampaignRequest {
881
- /** ID of the campaign to archive. */
969
+ /**
970
+ * ID of the campaign to archive.
971
+ * @format GUID
972
+ */
882
973
  campaignId?: string;
883
974
  }
884
975
  export interface ArchiveCampaignResponse {
885
976
  }
886
977
  /** Sent when status of the campaign is changed from "Active" to "Archived" */
887
978
  export interface Archived {
888
- /** ID of the campaign that was archived. */
979
+ /**
980
+ * ID of the campaign that was archived.
981
+ * @format GUID
982
+ */
889
983
  campaignId?: string;
890
984
  }
891
985
  export interface UnarchiveCampaignRequest {
892
- /** ID of the campaign to unarchive. */
986
+ /**
987
+ * ID of the campaign to unarchive.
988
+ * @format GUID
989
+ */
893
990
  campaignId?: string;
894
991
  }
895
992
  export interface UnarchiveCampaignResponse {
896
993
  }
897
994
  /** Sent when status of the campaign is changed from "Archived" to "Active" */
898
995
  export interface Unarchived {
899
- /** ID of the campaign whose status was changed to active. */
996
+ /**
997
+ * ID of the campaign whose status was changed to active.
998
+ * @format GUID
999
+ */
900
1000
  campaignId?: string;
901
1001
  }
902
1002
  export interface UpdateTitleRequest {
903
- /** ID of the campaign to change title of. */
1003
+ /**
1004
+ * ID of the campaign to change title of.
1005
+ * @format GUID
1006
+ */
904
1007
  campaignId?: string;
905
- /** New title to set. */
1008
+ /**
1009
+ * New title to set.
1010
+ * @maxLength 1000
1011
+ */
906
1012
  title?: string;
907
1013
  }
908
1014
  export interface UpdateTitleResponse {
909
1015
  }
910
1016
  export interface DeleteCampaignRequest {
911
- /** Campaign ID. */
1017
+ /**
1018
+ * Campaign ID.
1019
+ * @format GUID
1020
+ */
912
1021
  campaignId: string;
913
1022
  }
914
1023
  export interface DeleteCampaignResponse {
915
1024
  }
916
1025
  export interface ReuseCampaignRequest {
917
- /** ID of the message to be duplicated. */
1026
+ /**
1027
+ * ID of the message to be duplicated.
1028
+ * @format GUID
1029
+ */
918
1030
  campaignId: string;
919
1031
  }
920
1032
  export interface ReuseCampaignResponse {
@@ -922,9 +1034,15 @@ export interface ReuseCampaignResponse {
922
1034
  campaign?: Campaign;
923
1035
  }
924
1036
  export interface PreviewCampaignRequest {
925
- /** ID of the campaign to preview. */
1037
+ /**
1038
+ * ID of the campaign to preview.
1039
+ * @format GUID
1040
+ */
926
1041
  campaignId?: string;
927
- /** Preferred language for campaign content (optional). */
1042
+ /**
1043
+ * Preferred language for campaign content (optional).
1044
+ * @format LANGUAGE
1045
+ */
928
1046
  language?: string | null;
929
1047
  /** Values to replace campaign placeholders with (unique for each campaign). */
930
1048
  placeholders?: Record<string, PlaceholderContent>;
@@ -936,29 +1054,50 @@ export interface PreviewCampaignResponse {
936
1054
  html?: string;
937
1055
  }
938
1056
  export interface GetComposerRequest {
939
- /** Campaign ID. */
1057
+ /**
1058
+ * Campaign ID.
1059
+ * @format GUID
1060
+ */
940
1061
  campaignId?: string;
941
- /** Preferred language for campaign content (optional). */
1062
+ /**
1063
+ * Preferred language for campaign content (optional).
1064
+ * @format LANGUAGE
1065
+ */
942
1066
  language?: string | null;
943
1067
  }
944
1068
  export interface GetComposerResponse {
945
1069
  /** Composer. */
946
1070
  composer?: Composer;
947
- /** Campaign subject. */
1071
+ /**
1072
+ * Campaign subject.
1073
+ * @maxLength 1000
1074
+ */
948
1075
  emailSubject?: string;
949
- /** Campaign preheader (optional). */
1076
+ /**
1077
+ * Campaign preheader (optional).
1078
+ * @maxLength 1000
1079
+ */
950
1080
  emailPreheader?: string | null;
951
1081
  }
952
1082
  export interface UpdateComposerRequest {
953
- /** Campaign ID. */
1083
+ /**
1084
+ * Campaign ID.
1085
+ * @format GUID
1086
+ */
954
1087
  campaignId?: string;
955
1088
  /** Campaign composer. */
956
1089
  composer?: Composer;
957
1090
  /** Campaign editor type (optional, default "WEB"). */
958
1091
  campaignEditorType?: CampaignEditorType;
959
- /** Campaign subject (optional). */
1092
+ /**
1093
+ * Campaign subject (optional).
1094
+ * @maxLength 1000
1095
+ */
960
1096
  emailSubject?: string | null;
961
- /** Campaign preheader (optional). */
1097
+ /**
1098
+ * Campaign preheader (optional).
1099
+ * @maxLength 1000
1100
+ */
962
1101
  emailPreheader?: string | null;
963
1102
  }
964
1103
  /** specifies if campaign is being created and edited in web or mobile app */
@@ -972,9 +1111,15 @@ export interface CreateCampaignRequest {
972
1111
  composer?: Composer;
973
1112
  /** Campaign editor type (optional, default "WEB"). */
974
1113
  campaignEditorType?: CampaignEditorType;
975
- /** Campaign subject (optional). */
1114
+ /**
1115
+ * Campaign subject (optional).
1116
+ * @maxLength 1000
1117
+ */
976
1118
  emailSubject?: string | null;
977
- /** Campaign preheader (optional). */
1119
+ /**
1120
+ * Campaign preheader (optional).
1121
+ * @maxLength 1000
1122
+ */
978
1123
  emailPreheader?: string | null;
979
1124
  }
980
1125
  export interface CreateCampaignResponse {
@@ -982,17 +1127,29 @@ export interface CreateCampaignResponse {
982
1127
  campaign?: Campaign;
983
1128
  }
984
1129
  export interface ResendToNonOpenersRequest {
985
- /** ID of the campaign to resend. */
1130
+ /**
1131
+ * ID of the campaign to resend.
1132
+ * @format GUID
1133
+ */
986
1134
  campaignId?: string;
987
- /** Subject line to use with the resent copy of campaign. */
1135
+ /**
1136
+ * Subject line to use with the resent copy of campaign.
1137
+ * @maxLength 1000
1138
+ */
988
1139
  emailSubject?: string | null;
989
1140
  }
990
1141
  export interface ResendToNonOpenersResponse {
991
- /** ID of the newly created and resent campaign. */
1142
+ /**
1143
+ * ID of the newly created and resent campaign.
1144
+ * @format GUID
1145
+ */
992
1146
  campaignId?: string;
993
1147
  }
994
1148
  export interface GetAudienceRequest {
995
- /** Campaign ID. */
1149
+ /**
1150
+ * Campaign ID.
1151
+ * @format GUID
1152
+ */
996
1153
  campaignId: string;
997
1154
  }
998
1155
  export interface GetAudienceResponse {
@@ -1000,25 +1157,51 @@ export interface GetAudienceResponse {
1000
1157
  audience?: CampaignAudience;
1001
1158
  }
1002
1159
  export interface CampaignAudience {
1003
- /** IDs of contacts to whom to send the campaign. */
1160
+ /**
1161
+ * IDs of contacts to whom to send the campaign.
1162
+ * @format GUID
1163
+ * @maxSize 100
1164
+ */
1004
1165
  contactIds?: string[];
1005
- /** Labels IDs. */
1166
+ /**
1167
+ * Labels IDs.
1168
+ * @maxLength 100
1169
+ * @maxSize 20
1170
+ */
1006
1171
  labelIds?: string[];
1007
- /** Segment IDs. */
1172
+ /**
1173
+ * Segment IDs.
1174
+ * @format GUID
1175
+ * @maxSize 20
1176
+ */
1008
1177
  segmentIds?: string[];
1009
1178
  /** Filter for contacts in JSON format. */
1010
1179
  contactsFilter?: Record<string, any> | null;
1011
- /** Contacts plain text search expression (searches in name, phone and email fields). */
1180
+ /**
1181
+ * Contacts plain text search expression (searches in name, phone and email fields).
1182
+ * @minLength 1
1183
+ * @maxLength 100
1184
+ */
1012
1185
  contactsSearchTerm?: string | null;
1013
1186
  /** Should "inactive" contacts be excluded or not. */
1014
1187
  activeContactsOnly?: boolean;
1015
1188
  }
1016
1189
  export interface IdentifySenderAddressRequest {
1017
- /** Email address to verify. */
1190
+ /**
1191
+ * Email address to verify.
1192
+ * @format EMAIL
1193
+ * @minLength 6
1194
+ * @maxLength 254
1195
+ */
1018
1196
  emailAddress: string;
1019
1197
  }
1020
1198
  export interface IdentifySenderAddressResponse {
1021
- /** Actual "from" address that will be used for sending emails. */
1199
+ /**
1200
+ * Actual "from" address that will be used for sending emails.
1201
+ * @format EMAIL
1202
+ * @minLength 6
1203
+ * @maxLength 254
1204
+ */
1022
1205
  senderAddress?: string;
1023
1206
  }
1024
1207
  export interface DomainEvent extends DomainEventBodyOneOf {
@@ -1037,99 +1220,247 @@ export interface DomainEvent extends DomainEventBodyOneOf {
1037
1220
  */
1038
1221
  entityFqdn?: string;
1039
1222
  /**
1040
- * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
1041
- * This is although the created/updated/deleted notion is duplication of the oneof types
1042
- * Example: created/updated/deleted/started/completed/email_opened
1223
+ * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
1224
+ * This is although the created/updated/deleted notion is duplication of the oneof types
1225
+ * Example: created/updated/deleted/started/completed/email_opened
1226
+ */
1227
+ slug?: string;
1228
+ /** ID of the entity associated with the event. */
1229
+ entityId?: string;
1230
+ /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
1231
+ eventTime?: Date | null;
1232
+ /**
1233
+ * Whether the event was triggered as a result of a privacy regulation application
1234
+ * (for example, GDPR).
1235
+ */
1236
+ triggeredByAnonymizeRequest?: boolean | null;
1237
+ /** If present, indicates the action that triggered the event. */
1238
+ originatedFrom?: string | null;
1239
+ /**
1240
+ * A sequence number defining the order of updates to the underlying entity.
1241
+ * For example, given that some entity was updated at 16:00 and than again at 16:01,
1242
+ * it is guaranteed that the sequence number of the second update is strictly higher than the first.
1243
+ * As the consumer, you can use this value to ensure that you handle messages in the correct order.
1244
+ * To do so, you will need to persist this number on your end, and compare the sequence number from the
1245
+ * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
1246
+ */
1247
+ entityEventSequence?: string | null;
1248
+ }
1249
+ /** @oneof */
1250
+ export interface DomainEventBodyOneOf {
1251
+ createdEvent?: EntityCreatedEvent;
1252
+ updatedEvent?: EntityUpdatedEvent;
1253
+ deletedEvent?: EntityDeletedEvent;
1254
+ actionEvent?: ActionEvent;
1255
+ }
1256
+ export interface EntityCreatedEvent {
1257
+ entity?: string;
1258
+ }
1259
+ export interface RestoreInfo {
1260
+ deletedDate?: Date | null;
1261
+ }
1262
+ export interface EntityUpdatedEvent {
1263
+ /**
1264
+ * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
1265
+ * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
1266
+ * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
1267
+ */
1268
+ currentEntity?: string;
1269
+ }
1270
+ export interface EntityDeletedEvent {
1271
+ /** Entity that was deleted */
1272
+ deletedEntity?: string | null;
1273
+ }
1274
+ export interface ActionEvent {
1275
+ body?: string;
1276
+ }
1277
+ export interface MessageEnvelope {
1278
+ /**
1279
+ * App instance ID.
1280
+ * @format GUID
1281
+ */
1282
+ instanceId?: string | null;
1283
+ /**
1284
+ * Event type.
1285
+ * @maxLength 150
1286
+ */
1287
+ eventType?: string;
1288
+ /** The identification type and identity data. */
1289
+ identity?: IdentificationData;
1290
+ /** Stringify payload. */
1291
+ data?: string;
1292
+ }
1293
+ export interface IdentificationData extends IdentificationDataIdOneOf {
1294
+ /**
1295
+ * ID of a site visitor that has not logged in to the site.
1296
+ * @format GUID
1297
+ */
1298
+ anonymousVisitorId?: string;
1299
+ /**
1300
+ * ID of a site visitor that has logged in to the site.
1301
+ * @format GUID
1302
+ */
1303
+ memberId?: string;
1304
+ /**
1305
+ * ID of a Wix user (site owner, contributor, etc.).
1306
+ * @format GUID
1307
+ */
1308
+ wixUserId?: string;
1309
+ /**
1310
+ * ID of an app.
1311
+ * @format GUID
1312
+ */
1313
+ appId?: string;
1314
+ /** @readonly */
1315
+ identityType?: WebhookIdentityType;
1316
+ }
1317
+ /** @oneof */
1318
+ export interface IdentificationDataIdOneOf {
1319
+ /**
1320
+ * ID of a site visitor that has not logged in to the site.
1321
+ * @format GUID
1322
+ */
1323
+ anonymousVisitorId?: string;
1324
+ /**
1325
+ * ID of a site visitor that has logged in to the site.
1326
+ * @format GUID
1327
+ */
1328
+ memberId?: string;
1329
+ /**
1330
+ * ID of a Wix user (site owner, contributor, etc.).
1331
+ * @format GUID
1332
+ */
1333
+ wixUserId?: string;
1334
+ /**
1335
+ * ID of an app.
1336
+ * @format GUID
1337
+ */
1338
+ appId?: string;
1339
+ }
1340
+ export declare enum WebhookIdentityType {
1341
+ UNKNOWN = "UNKNOWN",
1342
+ ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
1343
+ MEMBER = "MEMBER",
1344
+ WIX_USER = "WIX_USER",
1345
+ APP = "APP"
1346
+ }
1347
+ export interface ListStatisticsRequest {
1348
+ /**
1349
+ * IDs of the campaigns to retrieve (max 100 campaigns).
1350
+ * @format GUID
1351
+ * @minSize 1
1352
+ * @maxSize 100
1353
+ */
1354
+ campaignIds: string[];
1355
+ }
1356
+ export interface ListStatisticsResponse {
1357
+ /** List of statistics. */
1358
+ statistics?: CampaignStatisticsContainer[];
1359
+ }
1360
+ export interface CampaignStatisticsContainer {
1361
+ /**
1362
+ * Campaign ID.
1363
+ * @format GUID
1364
+ */
1365
+ campaignId?: string;
1366
+ /** Landing page statistics. */
1367
+ landingPage?: LandingPageStatistics;
1368
+ /** Email campaign statistics. */
1369
+ email?: DistributionStatistics;
1370
+ }
1371
+ export interface ListRecipientsRequest {
1372
+ /**
1373
+ * Campaign ID.
1374
+ * @format GUID
1375
+ */
1376
+ campaignId: string;
1377
+ /**
1378
+ * __Required.__ Email activity to filter for. One of:
1379
+ * + `'DELIVERED'`
1380
+ * + `'OPENED'`
1381
+ * + `'CLICKED'`
1382
+ * + `'BOUNCED'`
1383
+ * + `'NOT_SENT'`
1384
+ */
1385
+ activity: RecipientsActivityEnum;
1386
+ /** Pagination options. */
1387
+ paging?: CursorPaging;
1388
+ }
1389
+ export declare enum RecipientsActivityEnum {
1390
+ UNKNOWN = "UNKNOWN",
1391
+ DELIVERED = "DELIVERED",
1392
+ OPENED = "OPENED",
1393
+ CLICKED = "CLICKED",
1394
+ BOUNCED = "BOUNCED",
1395
+ NOT_SENT = "NOT_SENT",
1396
+ SENT = "SENT",
1397
+ NOT_OPENED = "NOT_OPENED"
1398
+ }
1399
+ export interface CursorPaging {
1400
+ /**
1401
+ * Number of items to load.
1402
+ * @max 1000
1403
+ */
1404
+ limit?: number | null;
1405
+ /**
1406
+ * Pointer to the next or previous page in the list of results.
1407
+ *
1408
+ * You can get the relevant cursor token
1409
+ * from the `pagingMetadata` object in the previous call's response.
1410
+ * Not relevant for the first request.
1411
+ */
1412
+ cursor?: string | null;
1413
+ }
1414
+ export interface ListRecipientsResponse {
1415
+ /** List of recipients. */
1416
+ recipients?: CampaignRecipientDetails[];
1417
+ /** Details on the paged set of returned results. */
1418
+ pagingMetadata?: PagingMetadataV2;
1419
+ }
1420
+ export interface CampaignRecipientDetails {
1421
+ /**
1422
+ * Contact ID.
1423
+ * @format GUID
1043
1424
  */
1044
- slug?: string;
1045
- /** ID of the entity associated with the event. */
1046
- entityId?: string;
1047
- /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
1048
- eventTime?: Date | null;
1425
+ contactId?: string;
1426
+ /** Date and time of the last activity. */
1427
+ lastActivityDate?: Date | null;
1049
1428
  /**
1050
- * Whether the event was triggered as a result of a privacy regulation application
1051
- * (for example, GDPR).
1429
+ * Primary email address of the contact.
1430
+ * @format EMAIL
1052
1431
  */
1053
- triggeredByAnonymizeRequest?: boolean | null;
1054
- /** If present, indicates the action that triggered the event. */
1055
- originatedFrom?: string | null;
1432
+ emailAddress?: string;
1056
1433
  /**
1057
- * A sequence number defining the order of updates to the underlying entity.
1058
- * For example, given that some entity was updated at 16:00 and than again at 16:01,
1059
- * it is guaranteed that the sequence number of the second update is strictly higher than the first.
1060
- * As the consumer, you can use this value to ensure that you handle messages in the correct order.
1061
- * To do so, you will need to persist this number on your end, and compare the sequence number from the
1062
- * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
1434
+ * Full name of the contact (optional).
1435
+ * @maxLength 100
1063
1436
  */
1064
- entityEventSequence?: string | null;
1065
- }
1066
- /** @oneof */
1067
- export interface DomainEventBodyOneOf {
1068
- createdEvent?: EntityCreatedEvent;
1069
- updatedEvent?: EntityUpdatedEvent;
1070
- deletedEvent?: EntityDeletedEvent;
1071
- actionEvent?: ActionEvent;
1072
- }
1073
- export interface EntityCreatedEvent {
1074
- entity?: string;
1437
+ fullName?: string | null;
1438
+ /** Is this contact currently deleted from the site or not. */
1439
+ contactDeleted?: boolean;
1075
1440
  }
1076
- export interface RestoreInfo {
1077
- deletedDate?: Date | null;
1441
+ export interface PagingMetadataV2 {
1442
+ /** Number of items returned in the response. */
1443
+ count?: number | null;
1444
+ /** Offset that was requested. */
1445
+ offset?: number | null;
1446
+ /** Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. */
1447
+ total?: number | null;
1448
+ /** Flag that indicates the server failed to calculate the `total` field. */
1449
+ tooManyToCount?: boolean | null;
1450
+ /** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
1451
+ cursors?: Cursors;
1078
1452
  }
1079
- export interface EntityUpdatedEvent {
1453
+ export interface Cursors {
1080
1454
  /**
1081
- * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
1082
- * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
1083
- * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
1455
+ * Cursor string pointing to the next page in the list of results.
1456
+ * @maxLength 16000
1084
1457
  */
1085
- currentEntity?: string;
1086
- }
1087
- export interface EntityDeletedEvent {
1088
- /** Entity that was deleted */
1089
- deletedEntity?: string | null;
1090
- }
1091
- export interface ActionEvent {
1092
- body?: string;
1093
- }
1094
- export interface MessageEnvelope {
1095
- /** App instance ID. */
1096
- instanceId?: string | null;
1097
- /** Event type. */
1098
- eventType?: string;
1099
- /** The identification type and identity data. */
1100
- identity?: IdentificationData;
1101
- /** Stringify payload. */
1102
- data?: string;
1103
- }
1104
- export interface IdentificationData extends IdentificationDataIdOneOf {
1105
- /** ID of a site visitor that has not logged in to the site. */
1106
- anonymousVisitorId?: string;
1107
- /** ID of a site visitor that has logged in to the site. */
1108
- memberId?: string;
1109
- /** ID of a Wix user (site owner, contributor, etc.). */
1110
- wixUserId?: string;
1111
- /** ID of an app. */
1112
- appId?: string;
1113
- /** @readonly */
1114
- identityType?: WebhookIdentityType;
1115
- }
1116
- /** @oneof */
1117
- export interface IdentificationDataIdOneOf {
1118
- /** ID of a site visitor that has not logged in to the site. */
1119
- anonymousVisitorId?: string;
1120
- /** ID of a site visitor that has logged in to the site. */
1121
- memberId?: string;
1122
- /** ID of a Wix user (site owner, contributor, etc.). */
1123
- wixUserId?: string;
1124
- /** ID of an app. */
1125
- appId?: string;
1126
- }
1127
- export declare enum WebhookIdentityType {
1128
- UNKNOWN = "UNKNOWN",
1129
- ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
1130
- MEMBER = "MEMBER",
1131
- WIX_USER = "WIX_USER",
1132
- APP = "APP"
1458
+ next?: string | null;
1459
+ /**
1460
+ * Cursor pointing to the previous page in the list of results.
1461
+ * @maxLength 16000
1462
+ */
1463
+ prev?: string | null;
1133
1464
  }
1134
1465
  export interface ValidateLinkResponseNonNullableFields {
1135
1466
  valid: boolean;
@@ -1149,22 +1480,6 @@ interface DistributionStatisticsNonNullableFields {
1149
1480
  complained: number;
1150
1481
  notSent: number;
1151
1482
  }
1152
- interface CampaignStatisticsContainerNonNullableFields {
1153
- campaignId: string;
1154
- landingPage?: LandingPageStatisticsNonNullableFields;
1155
- email?: DistributionStatisticsNonNullableFields;
1156
- }
1157
- export interface ListStatisticsResponseNonNullableFields {
1158
- statistics: CampaignStatisticsContainerNonNullableFields[];
1159
- }
1160
- interface CampaignRecipientDetailsNonNullableFields {
1161
- contactId: string;
1162
- emailAddress: string;
1163
- contactDeleted: boolean;
1164
- }
1165
- export interface ListRecipientsResponseNonNullableFields {
1166
- recipients: CampaignRecipientDetailsNonNullableFields[];
1167
- }
1168
1483
  interface TotalStatisticsNonNullableFields {
1169
1484
  mailsSent: number;
1170
1485
  opened: number;
@@ -1219,10 +1534,32 @@ export interface GetAudienceResponseNonNullableFields {
1219
1534
  export interface IdentifySenderAddressResponseNonNullableFields {
1220
1535
  senderAddress: string;
1221
1536
  }
1537
+ interface CampaignStatisticsContainerNonNullableFields {
1538
+ campaignId: string;
1539
+ landingPage?: LandingPageStatisticsNonNullableFields;
1540
+ email?: DistributionStatisticsNonNullableFields;
1541
+ }
1542
+ export interface ListStatisticsResponseNonNullableFields {
1543
+ statistics: CampaignStatisticsContainerNonNullableFields[];
1544
+ }
1545
+ interface CampaignRecipientDetailsNonNullableFields {
1546
+ contactId: string;
1547
+ emailAddress: string;
1548
+ contactDeleted: boolean;
1549
+ }
1550
+ export interface ListRecipientsResponseNonNullableFields {
1551
+ recipients: CampaignRecipientDetailsNonNullableFields[];
1552
+ }
1222
1553
  export interface BaseEventMetadata {
1223
- /** App instance ID. */
1554
+ /**
1555
+ * App instance ID.
1556
+ * @format GUID
1557
+ */
1224
1558
  instanceId?: string | null;
1225
- /** Event type. */
1559
+ /**
1560
+ * Event type.
1561
+ * @maxLength 150
1562
+ */
1226
1563
  eventType?: string;
1227
1564
  /** The identification type and identity data. */
1228
1565
  identity?: IdentificationData;
@@ -1273,6 +1610,8 @@ export interface CampaignDistributedEnvelope {
1273
1610
  * Triggered when a campaign is successfully distributed to all recipients.
1274
1611
  * @permissionScope Access Verticals by Automations
1275
1612
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1613
+ * @permissionScope Set Up Automations
1614
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1276
1615
  * @permissionScope Read Email Marketing
1277
1616
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1278
1617
  * @permissionScope Manage Email Marketing
@@ -1292,6 +1631,8 @@ export interface CampaignPausedEnvelope {
1292
1631
  * Triggered when a scheduled campaign is paused.
1293
1632
  * @permissionScope Access Verticals by Automations
1294
1633
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1634
+ * @permissionScope Set Up Automations
1635
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1295
1636
  * @permissionScope Read Email Marketing
1296
1637
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1297
1638
  * @permissionScope Manage Email Marketing
@@ -1311,6 +1652,8 @@ export interface CampaignPublishedEnvelope {
1311
1652
  * Triggered when a draft campaign is published.
1312
1653
  * @permissionScope Access Verticals by Automations
1313
1654
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1655
+ * @permissionScope Set Up Automations
1656
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1314
1657
  * @permissionScope Read Email Marketing
1315
1658
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1316
1659
  * @permissionScope Manage Email Marketing
@@ -1330,6 +1673,8 @@ export interface CampaignRejectedEnvelope {
1330
1673
  * Triggered when a campaign is identified as abusive and rejected without sending emails to recipients.
1331
1674
  * @permissionScope Access Verticals by Automations
1332
1675
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1676
+ * @permissionScope Set Up Automations
1677
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1333
1678
  * @permissionScope Read Email Marketing
1334
1679
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1335
1680
  * @permissionScope Manage Email Marketing
@@ -1349,6 +1694,8 @@ export interface CampaignScheduledEnvelope {
1349
1694
  * Triggered when a campaign is scheduled to be sent out at the specific time.
1350
1695
  * @permissionScope Access Verticals by Automations
1351
1696
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1697
+ * @permissionScope Set Up Automations
1698
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1352
1699
  * @permissionScope Read Email Marketing
1353
1700
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1354
1701
  * @permissionScope Manage Email Marketing
@@ -1368,6 +1715,8 @@ export interface CampaignTerminatedEnvelope {
1368
1715
  * Triggered when the mailing list isn't clean and campaign was terminated.
1369
1716
  * @permissionScope Access Verticals by Automations
1370
1717
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1718
+ * @permissionScope Set Up Automations
1719
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1371
1720
  * @permissionScope Read Email Marketing
1372
1721
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1373
1722
  * @permissionScope Manage Email Marketing
@@ -1387,6 +1736,8 @@ export interface CampaignCreatedEnvelope {
1387
1736
  * Triggered when a campaign is created.
1388
1737
  * @permissionScope Access Verticals by Automations
1389
1738
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1739
+ * @permissionScope Set Up Automations
1740
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1390
1741
  * @permissionScope Read Email Marketing
1391
1742
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1392
1743
  * @permissionScope Manage Email Marketing
@@ -1405,6 +1756,8 @@ export interface CampaignDeletedEnvelope {
1405
1756
  * Triggered when a campaign is deleted.
1406
1757
  * @permissionScope Access Verticals by Automations
1407
1758
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1759
+ * @permissionScope Set Up Automations
1760
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1408
1761
  * @permissionScope Read Email Marketing
1409
1762
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1410
1763
  * @permissionScope Manage Email Marketing
@@ -1424,6 +1777,8 @@ export interface CampaignEmailActivityUpdatedEnvelope {
1424
1777
  * Triggered when an email campaign has a new recipient activity.
1425
1778
  * @permissionScope Access Verticals by Automations
1426
1779
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1780
+ * @permissionScope Set Up Automations
1781
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1427
1782
  * @permissionScope Read Email Marketing
1428
1783
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1429
1784
  * @permissionScope Manage Email Marketing
@@ -1441,11 +1796,12 @@ export declare function onCampaignEmailActivityUpdated(handler: (event: Campaign
1441
1796
  * If you provide a link as a placeholder, it's returned in a response as valid.
1442
1797
  * @param url - URL to validate.
1443
1798
  * @public
1444
- * @documentationMaturity preview
1445
1799
  * @requiredField url
1446
1800
  * @permissionId Shoutout.Manage
1447
1801
  * @permissionScope Access Verticals by Automations
1448
1802
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1803
+ * @permissionScope Set Up Automations
1804
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1449
1805
  * @permissionScope Manage Email Marketing
1450
1806
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1451
1807
  * @applicableIdentity APP
@@ -1456,75 +1812,18 @@ export declare function validateLink(url: string): Promise<ValidateLinkResponse
1456
1812
  * Validates links that are inside the provided HTML. This method automatically takes out links from the HTML block and validates them. Use this method when you want to check whether the link complies with the abuse rules and can be used in a campaign.
1457
1813
  * @param html - HTML string with links.
1458
1814
  * @public
1459
- * @documentationMaturity preview
1460
1815
  * @requiredField html
1461
1816
  * @permissionId Shoutout.Manage
1462
1817
  * @permissionScope Access Verticals by Automations
1463
1818
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1819
+ * @permissionScope Set Up Automations
1820
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1464
1821
  * @permissionScope Manage Email Marketing
1465
1822
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1466
1823
  * @applicableIdentity APP
1467
1824
  * @fqn wix.emailmarketing.api.v1.CampaignValidationService.ValidateHtmlLinks
1468
1825
  */
1469
1826
  export declare function validateHtmlLinks(html: string): Promise<ValidateHtmlLinksResponse & ValidateHtmlLinksResponseNonNullableFields>;
1470
- /**
1471
- * Retrieves a list of statistics for up to 100 selected campaigns.
1472
- *
1473
- * For each campaign, you receive the total activity count for the campaign's landing page and email. For example, the total
1474
- * amount of times the landing page was opened, or the total amount of email recipients that clicked a link in an email.
1475
- *
1476
- * Use [List Campaigns](#listcampaigns) to retrieve additional information for your campaigns.
1477
- * Use [List Recipients](#listrecipients) to retrieve a list of recipients and their activities related to a selected campaign.
1478
- * @param campaignIds - IDs of the campaigns to retrieve (max 100 campaigns).
1479
- * @public
1480
- * @requiredField campaignIds
1481
- * @permissionId Shoutout.Read
1482
- * @permissionScope Access Verticals by Automations
1483
- * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1484
- * @permissionScope Read Email Marketing
1485
- * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1486
- * @permissionScope Manage Email Marketing
1487
- * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1488
- * @applicableIdentity APP
1489
- * @fqn wix.emailmarketing.api.v1.CampaignStatisticsService.ListStatistics
1490
- */
1491
- export declare function listStatistics(campaignIds: string[]): Promise<ListStatisticsResponse & ListStatisticsResponseNonNullableFields>;
1492
- /**
1493
- * Retrieves a list of recipients for a selected campaign based on a specific recipient activity.
1494
- *
1495
- * Pages are returned with a maximum of 1,000 recipients per page and defaults to 40 recipients per page.
1496
- *
1497
- * Use [List Statistics](#liststatistics) to retrieve a list of activity for selected campaigns.
1498
- * Use [List Campaigns](#listcampaigns) to retrieve additional information for your campaigns.
1499
- *
1500
- * If no `activity` is included, this endpoint returns an error.
1501
- *
1502
- * @param campaignId - Campaign ID.
1503
- * @param activity - __Required.__ Email activity to filter for. One of:
1504
- * + `'DELIVERED'`
1505
- * + `'OPENED'`
1506
- * + `'CLICKED'`
1507
- * + `'BOUNCED'`
1508
- * + `'NOT_SENT'`
1509
- * @public
1510
- * @requiredField activity
1511
- * @requiredField campaignId
1512
- * @param options - Options to use when getting the list of recipients.
1513
- * @permissionId Shoutout.Read
1514
- * @permissionScope Access Verticals by Automations
1515
- * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1516
- * @permissionScope Read Email Marketing
1517
- * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1518
- * @permissionScope Manage Email Marketing
1519
- * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1520
- * @applicableIdentity APP
1521
- * @fqn wix.emailmarketing.api.v1.CampaignStatisticsService.ListRecipients
1522
- */
1523
- export declare function listRecipients(campaignId: string, activity: RecipientsActivityEnum, options?: ListRecipientsOptions): Promise<ListRecipientsResponse & ListRecipientsResponseNonNullableFields>;
1524
- export interface ListRecipientsOptions {
1525
- /** Pagination options. */
1526
- paging?: CursorPaging;
1527
- }
1528
1827
  /**
1529
1828
  * Retrieves information about an email campaign.
1530
1829
  * @param campaignId - Campaign ID.
@@ -1534,6 +1833,8 @@ export interface ListRecipientsOptions {
1534
1833
  * @permissionId Shoutout.Manage
1535
1834
  * @permissionScope Access Verticals by Automations
1536
1835
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1836
+ * @permissionScope Set Up Automations
1837
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1537
1838
  * @permissionScope Manage Email Marketing
1538
1839
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1539
1840
  * @applicableIdentity APP
@@ -1558,6 +1859,8 @@ export interface GetCampaignOptions {
1558
1859
  * @permissionId Shoutout.Read
1559
1860
  * @permissionScope Access Verticals by Automations
1560
1861
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1862
+ * @permissionScope Set Up Automations
1863
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1561
1864
  * @permissionScope Read Email Marketing
1562
1865
  * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
1563
1866
  * @permissionScope Manage Email Marketing
@@ -1601,6 +1904,8 @@ export interface ListCampaignsOptions {
1601
1904
  * @permissionId Shoutout.Manage
1602
1905
  * @permissionScope Access Verticals by Automations
1603
1906
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1907
+ * @permissionScope Set Up Automations
1908
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1604
1909
  * @permissionScope Manage Email Marketing
1605
1910
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1606
1911
  * @applicableIdentity APP
@@ -1623,6 +1928,8 @@ export interface PublishCampaignOptions {
1623
1928
  * @permissionId Shoutout.Manage
1624
1929
  * @permissionScope Access Verticals by Automations
1625
1930
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1931
+ * @permissionScope Set Up Automations
1932
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1626
1933
  * @permissionScope Manage Email Marketing
1627
1934
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1628
1935
  * @applicableIdentity APP
@@ -1630,9 +1937,15 @@ export interface PublishCampaignOptions {
1630
1937
  */
1631
1938
  export declare function sendTest(campaignId: string, options?: SendTestOptions): Promise<void>;
1632
1939
  export interface SendTestOptions {
1633
- /** Email subject. */
1940
+ /**
1941
+ * Email subject.
1942
+ * @maxLength 1000
1943
+ */
1634
1944
  emailSubject?: string | null;
1635
- /** Recipient email address. */
1945
+ /**
1946
+ * Recipient email address.
1947
+ * @format EMAIL
1948
+ */
1636
1949
  toEmailAddress: string;
1637
1950
  }
1638
1951
  /**
@@ -1643,6 +1956,8 @@ export interface SendTestOptions {
1643
1956
  * @permissionId Shoutout.Manage
1644
1957
  * @permissionScope Access Verticals by Automations
1645
1958
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1959
+ * @permissionScope Set Up Automations
1960
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1646
1961
  * @permissionScope Manage Email Marketing
1647
1962
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1648
1963
  * @applicableIdentity APP
@@ -1659,6 +1974,8 @@ export declare function pauseScheduling(campaignId: string): Promise<void>;
1659
1974
  * @permissionId Shoutout.Manage
1660
1975
  * @permissionScope Access Verticals by Automations
1661
1976
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1977
+ * @permissionScope Set Up Automations
1978
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1662
1979
  * @permissionScope Manage Email Marketing
1663
1980
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1664
1981
  * @applicableIdentity APP
@@ -1673,6 +1990,8 @@ export declare function reschedule(campaignId: string, sendAt: Date | null): Pro
1673
1990
  * @permissionId Shoutout.Manage
1674
1991
  * @permissionScope Access Verticals by Automations
1675
1992
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
1993
+ * @permissionScope Set Up Automations
1994
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1676
1995
  * @permissionScope Manage Email Marketing
1677
1996
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1678
1997
  * @applicableIdentity APP
@@ -1687,6 +2006,8 @@ export declare function deleteCampaign(campaignId: string): Promise<void>;
1687
2006
  * @permissionId Shoutout.Manage
1688
2007
  * @permissionScope Access Verticals by Automations
1689
2008
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
2009
+ * @permissionScope Set Up Automations
2010
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1690
2011
  * @permissionScope Manage Email Marketing
1691
2012
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1692
2013
  * @applicableIdentity APP
@@ -1701,6 +2022,8 @@ export declare function reuseCampaign(campaignId: string): Promise<ReuseCampaign
1701
2022
  * @permissionId Shoutout.Manage
1702
2023
  * @permissionScope Access Verticals by Automations
1703
2024
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
2025
+ * @permissionScope Set Up Automations
2026
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1704
2027
  * @permissionScope Manage Email Marketing
1705
2028
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1706
2029
  * @applicableIdentity APP
@@ -1715,10 +2038,74 @@ export declare function getAudience(campaignId: string): Promise<GetAudienceResp
1715
2038
  * @permissionId Shoutout.Manage
1716
2039
  * @permissionScope Access Verticals by Automations
1717
2040
  * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
2041
+ * @permissionScope Set Up Automations
2042
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
1718
2043
  * @permissionScope Manage Email Marketing
1719
2044
  * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
1720
2045
  * @applicableIdentity APP
1721
2046
  * @fqn wix.emailmarketing.api.v1.CampaignService.IdentifySenderAddress
1722
2047
  */
1723
2048
  export declare function identifySenderAddress(emailAddress: string): Promise<IdentifySenderAddressResponse & IdentifySenderAddressResponseNonNullableFields>;
2049
+ /**
2050
+ * Retrieves a list of statistics for up to 100 selected campaigns.
2051
+ *
2052
+ * For each campaign, you receive the total activity count for the campaign's landing page and email. For example, the total
2053
+ * amount of times the landing page was opened, or the total amount of email recipients that clicked a link in an email.
2054
+ *
2055
+ * Use [List Campaigns](#listcampaigns) to retrieve additional information for your campaigns.
2056
+ * Use [List Recipients](#listrecipients) to retrieve a list of recipients and their activities related to a selected campaign.
2057
+ * @param campaignIds - IDs of the campaigns to retrieve (max 100 campaigns).
2058
+ * @public
2059
+ * @requiredField campaignIds
2060
+ * @permissionId Shoutout.Read
2061
+ * @permissionScope Access Verticals by Automations
2062
+ * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
2063
+ * @permissionScope Set Up Automations
2064
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
2065
+ * @permissionScope Read Email Marketing
2066
+ * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
2067
+ * @permissionScope Manage Email Marketing
2068
+ * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
2069
+ * @applicableIdentity APP
2070
+ * @fqn wix.emailmarketing.api.v1.CampaignStatisticsService.ListStatistics
2071
+ */
2072
+ export declare function listStatistics(campaignIds: string[]): Promise<ListStatisticsResponse & ListStatisticsResponseNonNullableFields>;
2073
+ /**
2074
+ * Retrieves a list of recipients for a selected campaign based on a specific recipient activity.
2075
+ *
2076
+ * Pages are returned with a maximum of 1,000 recipients per page and defaults to 40 recipients per page.
2077
+ *
2078
+ * Use [List Statistics](#liststatistics) to retrieve a list of activity for selected campaigns.
2079
+ * Use [List Campaigns](#listcampaigns) to retrieve additional information for your campaigns.
2080
+ *
2081
+ * If no `activity` is included, this endpoint returns an error.
2082
+ *
2083
+ * @param campaignId - Campaign ID.
2084
+ * @param activity - __Required.__ Email activity to filter for. One of:
2085
+ * + `'DELIVERED'`
2086
+ * + `'OPENED'`
2087
+ * + `'CLICKED'`
2088
+ * + `'BOUNCED'`
2089
+ * + `'NOT_SENT'`
2090
+ * @public
2091
+ * @requiredField activity
2092
+ * @requiredField campaignId
2093
+ * @param options - Options to use when getting the list of recipients.
2094
+ * @permissionId Shoutout.Read
2095
+ * @permissionScope Access Verticals by Automations
2096
+ * @permissionScopeId SCOPE.CRM.ACCESS-VERTICALS-BY-AUTOMATIONS
2097
+ * @permissionScope Set Up Automations
2098
+ * @permissionScopeId SCOPE.CRM.SETUP-AUTOMATIONS
2099
+ * @permissionScope Read Email Marketing
2100
+ * @permissionScopeId SCOPE.DC-PROMOTE.READ-EMAIL-MARKETING
2101
+ * @permissionScope Manage Email Marketing
2102
+ * @permissionScopeId SCOPE.DC-PROMOTE.EMAIL-MARKETING
2103
+ * @applicableIdentity APP
2104
+ * @fqn wix.emailmarketing.api.v1.CampaignStatisticsService.ListRecipients
2105
+ */
2106
+ export declare function listRecipients(campaignId: string, activity: RecipientsActivityEnum, options?: ListRecipientsOptions): Promise<ListRecipientsResponse & ListRecipientsResponseNonNullableFields>;
2107
+ export interface ListRecipientsOptions {
2108
+ /** Pagination options. */
2109
+ paging?: CursorPaging;
2110
+ }
1724
2111
  export {};