Copy a Constant Contact list into HubSpot

**Objective:** Put every member of the Constant Contact list named like `{constant-contact-list-name}` who is already a HubSpot contact into the manual HubSpot contact list `{hubspot-list-name}`, creating the HubSpot list if it does not exist, after the user confirms.

**Step 1: Resolve the Constant Contact list**

Call `constant-contact-get-contact-list` with `name.contains` set to `{constant-contact-list-name}`. Exactly one list must match. If none or several match, list them (name, active-members) and stop. Keep its `list-id`.

**Step 2: Members in Constant Contact**

Call `constant-contact-get-contact-list-member` with `list-id` set to it and `max-records` 500. Keep `email-address`, `first-name`, `last-name` and `permission-to-send`.

**Step 3: Resolve the HubSpot list**

Call `hubspot-get-lists` with `name` set to `{hubspot-list-name}` and `object-type` set to 0-1. If several lists come back, list them and stop. If one comes back, its `processing-type` must be MANUAL; if it is not, say HubSpot manages that list's members and stop. Keep its `list-id`, then call `hubspot-get-contact-list-membership` with `list-id` set to it and `max-records` 1000, and note the contact-id of every current member. If no list comes back, it will be created in the write step.

**Step 4: Match each person in HubSpot**

For each distinct email address, call `hubspot-get-contacts` with `email` set to it and keep `record-id`, first and last name and `lifecycle-stage`. Sort people into: to add (a HubSpot contact not yet on the list), already on the list, not in HubSpot. If one email matches more than one contact, list them under "ambiguous" and do not add any of them. This prompt does not create contacts.

**Step 5: Confirm**

Show the HubSpot list (its name, id and size, or "will be created as a manual contact list"), then the groups: to add (email, name, Constant Contact permission-to-send), already on the list (count), not in HubSpot (list), ambiguous (list). Ask the user to confirm the "to add" group, or to name people to leave out. Do nothing more until they confirm.

**Step 6: Write**

Only after confirmation:

1. If the list does not exist, call `hubspot-add-list` once with `name` set to `{hubspot-list-name}`, `object-type` set to 0-1 and `processing-type` set to MANUAL. Keep the returned `id` as the list-id.
2. Call `hubspot-add-list-members` with `list-id` and `record-ids` set to the confirmed contacts' record-ids, comma-separated, in batches of at most 100.

**Step 7: Verify and report**

Call `hubspot-get-lists` with `list-id` and report its size (HubSpot can take a minute to update it). Then the totals: added, already on the list, not in HubSpot, ambiguous, failed (with the error).

**Rules & Guidelines:**

* `constant-contact-get-contact-list` and `constant-contact-get-contact-list-member` are on the Constant Contact server; `hubspot-get-lists`, `hubspot-get-contact-list-membership`, `hubspot-get-contacts`, `hubspot-add-list` and `hubspot-add-list-members` are on the hubspot server.
* `hubspot-add-list` (at most once) and `hubspot-add-list-members` (once per batch) are the only write tools this prompt may call, and only after confirmation. Do NOT call `hubspot-remove-list-members` or `hubspot-add-contact`, and call no other hubspot-add, hubspot-update, hubspot-rename, hubspot-remove, hubspot-subscribe, hubspot-unsubscribe or hubspot-import tool. This prompt only adds members; it never removes anyone already on the list.
* Constant Contact is read-only here. Do NOT call `constant-contact-add-contact`, `constant-contact-update-contact`, `constant-contact-add-contact-note`, `constant-contact-add-contact-list`, `constant-contact-update-contact-list`, `constant-contact-add-contact-tag`, `constant-contact-update-contact-tag`, `constant-contact-add-campaign`, `constant-contact-update-campaign` or `constant-contact-resend-campaign-to-non-openers`.
* Membership of a HubSpot list does not change anyone's email consent. Do not treat it as a subscription, and do not subscribe anyone.
* Match on email address only, compared case-insensitively with surrounding spaces trimmed.

**Validation:**

* If Constant Contact returns nobody, say so and stop before creating the list.
* If nobody is left to add, report the counts and stop without asking for confirmation or creating the list.
* If one batch fails, report it with the error and continue with the next.