AddThisFeature

Kit Subscriber Sync

Send subscribers to Kit with the form, tags, and fields matching how they signed up.

moderate Sales & Marketing Tools

What it adds

A sync that maps each app signup path to a specific Kit form or sequence and keeps subscriber fields and tags aligned.

What your agent is told to do

5
  1. 1

    Enumerate the distinct ways someone becomes a subscriber in the app — each signup form, lead magnet, checkout, and import — and map each one to exactly one destination form or sequence, configured rather than hardcoded.

  2. 2

    Store the provider's subscriber ID alongside the local record and use it for subsequent updates, but keep the app's own user or lead ID as the identity of record. The provider ID identifies a subscription, not a person.

  3. 3

    Make every enrollment idempotent using a key derived from the subscriber and the destination, so a retried job confirms the existing enrollment instead of adding a second one.

  4. 4

    Read the subscriber's current state before writing. Someone who unsubscribed must stay unsubscribed, and a new signup by an unsubscribed address needs a fresh, recorded opt-in before you resubscribe them.

  5. 5

    Do not resolve tags and forms by name at send time. Names get edited, and a rename will quietly create a new tag while the old one keeps its audience — resolve to stable identifiers at mapping time and re-validate them.

Edge cases it handles

8
  • One app signup can plausibly belong to several forms or sequences. Force the mapping to pick one destination per entry point, because ambiguity here produces subscribers who receive two overlapping onboarding sequences.
  • An unsubscribed address that signs up again is not an instruction to resubscribe. Preserve the unsubscribe, capture the new consent explicitly with a timestamp and source, and only then re-enable sending.
  • Job retries and provider retries both re-run enrollment. Without an idempotency key per subscriber and destination, one signup adds the same tag twice and starts the sequence from the beginning again.
  • Tags and forms get renamed or deleted between configuration and use. A mapping pointing at something that no longer exists must pause with a message naming it, and must never create a replacement by name on the fly.
  • Provider subscriber IDs are not global identity. Two app users sharing a household email, or one user changing their address, will break any model that treats the provider ID as the person — key on the app's own record instead.
  • If the app syncs to more than one email provider, exactly one of them must be designated authoritative for consent, and this brief must read that decision rather than making its own. Two providers each restoring the other's unsubscribes is worse than no sync.
  • Tokens expire and connections get revoked from the provider side. Hold queued enrollments, show the connection as broken, and resume from the held queue on reconnection.
  • When the provider is unreachable, the app's signup must still succeed and the confirmation must not promise an email that has not been queued anywhere.

Definition of done

9
  • Each signup path resolves to exactly one configured form or sequence.
  • Retried jobs never add a duplicate tag or restart a sequence.
  • An unsubscribed address is not resubscribed without a newly recorded opt-in.
  • Renamed or deleted tags and forms pause the mapping with a named error rather than being recreated.
  • Provider subscriber IDs are stored as references, and the app's own record remains the identity of record.
  • Consent authority is defined in one place when multiple email providers are connected.
  • A provider outage leaves the signup successful and the enrollment queued.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.