V24.6.0 - 2024-06-13

src/ConstantContact/Definition/ContactsExport.php

@@ -9,7 +9,7 @@
  * @property array<\PHPFUI\ConstantContact\UUID> $list_ids Exports all of the contacts inside of up to 50 contact lists. This property is mutually exclusive with <code>contact_ids</code>.
  * @property int $segment_id Specify the <code>segment_id</code> from which you want to export all contacts that meet the specified <code>segment_criteria</code>. This property is mutually exclusive with <code>contact_ids</code> and <code>list_ids</code>. You can only specify one <code>segment_id</code>.
  * @property array $fields Use this array to export specific contact fields. You must export <code>email_address</code> to successfully export <code>email_optin_source</code>, <code>email_optin_date</code>, <code>email_optout_source</code>, <code>email_optout_date</code>, or <code>email_optout_reason</code>.
- * @property string $status Allows you to export only contacts that have a specific status value. Possible values are <code>active</code>, <code>unsubscribed</code>, or <code>removed</code>
+ * @property string $status Allows you to export only contacts that have a specific status value. Possible values are <code>active</code> (billable), <code>unsubscribed</code>, or <code>removed</code>
  */
 class ContactsExport extends \PHPFUI\ConstantContact\Definition\Base
 	{

src/ConstantContact/Definition/ListActivityAddContacts.php

@@ -6,12 +6,14 @@
 
 /**
  * @property \PHPFUI\ConstantContact\Definition\Source $source The <code>source</code> object specifies which contacts you are adding to your targeted lists using one of four mutually exclusive properties.
+ * @property \PHPFUI\ConstantContact\Definition\Exclude $exclude
  * @property array<\PHPFUI\ConstantContact\UUID> $list_ids Specifies which lists (up to 50) you are adding your source contacts to.
  */
 class ListActivityAddContacts extends \PHPFUI\ConstantContact\Definition\Base
 	{
 	protected static array $fields = [
 		'source' => '\PHPFUI\ConstantContact\Definition\Source',
+		'exclude' => '\PHPFUI\ConstantContact\Definition\Exclude',
 		'list_ids' => 'array<\PHPFUI\ConstantContact\UUID>',
 
 	];

src/ConstantContact/Definition/ListActivityRemoveContacts.php

@@ -5,19 +5,16 @@
 namespace PHPFUI\ConstantContact\Definition;
 
 /**
- * @property \PHPFUI\ConstantContact\Definition\Source $source The <code>source</code> object specifies which contacts to remove from your targeted lists using one of three mutually exclusive properties.
- * @property array<\PHPFUI\ConstantContact\UUID> $list_ids Specifies which lists (up to 50) to remove your source contacts from.
+ * @property \PHPFUI\ConstantContact\Definition\Source $source Specifies the contacts to remove from your target list(s) using one of several mutually exclusive properties.
+ * @property \PHPFUI\ConstantContact\Definition\Exclude $exclude
+ * @property array<\PHPFUI\ConstantContact\UUID> $list_ids Specify up to 50 target <code>list_id</code>s from which to remove contacts.
  */
 class ListActivityRemoveContacts extends \PHPFUI\ConstantContact\Definition\Base
 	{
 	protected static array $fields = [
 		'source' => '\PHPFUI\ConstantContact\Definition\Source',
+		'exclude' => '\PHPFUI\ConstantContact\Definition\Exclude',
 		'list_ids' => 'array<\PHPFUI\ConstantContact\UUID>',
 
-	];
-
-	protected static array $maxLength = [
-		'list_ids' => 50,
-
 	];
 	}

src/ConstantContact/Definition/Provision.php

@@ -14,7 +14,7 @@
  * @property string $time_zone_id The offical time zone to use to represent the physical location associated with the client account.
  * @property string $website The client's website URL. Specifying the website URL eliminates the need for clients to provide that information. Requires a valid URL starting with http:// or https://.
  * @property string $login_name A unique login name to associate with the client account. The name must only contain alphanumeric characters and '-', '_', '@','.','+'.
- * @property string $password Required if not using Single Sign On (SSO) or external authenticator. The password to associate with the client account. Passwords must be a minimum of six characters in length and have no spaces. The password is not returned in the response payload for security reasons. If using SSO authentication, use <code>external_provider</code> and <code>external_id</code> instead of <code>password</code>.
+ * @property string $password Required if not using Single Sign On (SSO) or external authenticator. The password to associate with the client account. Passwords must be at least 8 characters and no more than 80 characters in length. Passwords can contain alphabetical letters (A-Z) and (a-z), numbers (0-9), special characters (! @ # $ etc.) and spaces. Passwords should not contain any part of your username and cannot be the same as your last password, or be listed on an industry database; we check for easily guessed or compromised passwords. Your new password is not returned in the response payload for security reasons. If using SSO authentication, use <code>idp_provider</code> and <code>idp_provider_id</code> instead of <code>password</code>.
  * @property string $first_name The client account owner's first name.
  * @property string $last_name The client account owner's last name.
  * @property string $partner_account_id The unique client account identifier that partners define and use for billing and reporting purposes.
@@ -72,7 +72,7 @@ class Provision extends \PHPFUI\ConstantContact\Definition\Base
 		'organization_name' => 1,
 		'organization_phone' => 5,
 		'login_name' => 6,
-		'password' => 6,
+		'password' => 8,
 		'first_name' => 2,
 		'last_name' => 2,
 

src/ConstantContact/Definition/Source.php

@@ -8,7 +8,7 @@
  * @property array<\PHPFUI\ConstantContact\UUID> $contact_ids An array of contacts IDs.
  * @property array<\PHPFUI\ConstantContact\UUID> $list_ids An array of list IDs ( <code>list_id</code> ).
  * @property array<\PHPFUI\ConstantContact\UUID> $tag_ids An array of tags ( <code>tag_id</code> ).
- * @property bool $all_active_contacts Use to identify contacts with an active status.
+ * @property bool $all_active_contacts Use to identify contacts with an active (billable) status.
  * @property bool $new_subscriber Use to identify newly subscribed contacts.
  */
 class Source extends \PHPFUI\ConstantContact\Definition\Base

src/ConstantContact/Definition/TagAddRemoveContacts.php

@@ -6,7 +6,7 @@
 
 /**
  * @property \PHPFUI\ConstantContact\Definition\Source $source Select the source used to identify contacts to which a tag is added or removed. Source types are mutually exclusive.
- * @property \PHPFUI\ConstantContact\Definition\Exclude $exclude Use to exclude specified contacts from being added or removed from a tag. Only applicable if the specified source is either <code>all_active_contacts</code> or <code>list_ids</code>.
+ * @property \PHPFUI\ConstantContact\Definition\Exclude $exclude Use to exclude specified contacts from being added or removed from a tag. Only applicable if the specified source is either <code>all_active_contacts</code> (billable) or <code>list_ids</code>.
  * @property array<\PHPFUI\ConstantContact\UUID> $tag_ids An array of tags (<code>tag_id</code>) to add to all contacts meeting the specified source criteria.
  */
 class TagAddRemoveContacts extends \PHPFUI\ConstantContact\Definition\Base

src/ConstantContact/V3/Activities/RemoveListMemberships.php

@@ -15,11 +15,14 @@ public function __construct(\PHPFUI\ConstantContact\Client $client)
 	 * Remove Contacts from Lists
 	 *
 	 * Use this method to create an activity that removes contacts from one
-	 * or more lists. Use the properties in the `source` object to remove specific
-	 * contacts from your targeted lists. Use the `list_ids` array to specify
-	 * the lists from which you want to remove the source contacts.
+	 * or more contact lists. Use the properties in the `source` object to
+	 * remove specific contacts from your lists. Use the `list_ids` array to
+	 * specify the target lists from which contacts are removed. Optionally,
+	 * if the source is  `all_active_contacts` (billable) or `list_ids`, use
+	 * the `exclude` object to exclude specific contacts from being removed
+	 * from the destination lists.
 	 *
-	 * @param \PHPFUI\ConstantContact\Definition\ListActivityRemoveContacts $body The JSON payload used to create the 'remove contacts from lists' activity
+	 * @param \PHPFUI\ConstantContact\Definition\ListActivityRemoveContacts $body The JSON payload used to create the Remove Contacts from Lists' activity
 	 */
 	public function post(\PHPFUI\ConstantContact\Definition\ListActivityRemoveContacts $body) : array
 		{

src/ConstantContact/V3/Contacts/Counts.php

@@ -16,12 +16,13 @@ public function __construct(\PHPFUI\ConstantContact\Client $client)
 	 *
 	 * Use to get the total contacts count for the account and the total contact-consent
 	 * counts for each consent state. Optionally, to include the total number
-	 * of new subscribers in the results, use `new_subscribers` in the `include`
-	 * query parameter. To optimize open rates, reduce spam reports, and help
-	 * grow your business,  you must value your contact's consent to receive
-	 * or to not receive your emails.
+	 * of contacts that subscribed within the last 30 days in the results,
+	 * use `new_subscribers` in the `include` query parameter. To optimize
+	 * open rates, reduce spam reports, and help grow your business,  you must
+	 * value your contact's consent to receive or to not receive your emails.
 	 *
-	 * @param string $include Use to return the total number of new contact subscribers in the results.
+	 *
+	 * @param string $include Use to return the total number of contacts that subscribed within the last 30 days in the results.
 	 */
 	public function get(?string $include = null) : array
 		{