AddThisFeature

Third-Party Account Import

Pull existing data straight from another service instead of asking for a file.

involved Integrations

What it adds

An API-driven import that previews what will be created, then writes it in a resumable, deduplicated way.

What your agent is told to do

6
  1. 1

    Let the user pick what to import before authorizing, and request only the scopes those selections need. Do not ask for full account access to import one list.

  2. 2

    Fetch through the provider's pagination to completion and persist a cursor as you go, so the job resumes from where it stopped rather than restarting.

  3. 3

    Show a preview before writing anything: how many records will be created, how many match existing ones, and what the duplicate rule will do with them.

  4. 4

    Store the provider's record ID alongside your own, scoped to the connection. Do NOT treat a provider ID as globally unique — two connections to the same provider will collide.

  5. 5

    Establishing the connection itself is owned by OAuth Integration Connections, file-based import by CSV Import, and the progress display by Background Job Progress. Use them rather than rebuilding them.

  6. 6

    Make the whole import reversible or at least identifiable — tag imported records with the import run so a bad import can be found and undone.

Edge cases it handles

6
  • Rate limits will be hit mid-import. Respect the provider's retry-after, pause the job, and resume — do not fail the whole run.
  • The token can expire partway through a long import. Refresh and continue; if reauthorization is needed, pause and tell the user rather than discarding progress.
  • The provider's data may change while you are paginating, producing duplicates or gaps. Deduplicate on provider ID rather than trusting page boundaries.
  • Referenced records may point at objects the user did not select or does not have scope for. Import them as placeholders or skip them explicitly; do not fail silently.
  • A user may run the same import twice. The second run must update matched records rather than doubling everything.
  • Fields the provider allows and yours does not — longer text, unsupported characters, missing required values — need a stated per-record outcome, reported at the end.

Definition of done

8
  • Requested scopes correspond to the data the user selected to import.
  • Pagination completes and the job resumes from a persisted cursor after interruption.
  • A preview shows create, match, and skip counts before any write occurs.
  • Provider IDs are stored scoped to the connection, not as global identifiers.
  • Re-running an import updates matched records instead of duplicating them.
  • Every skipped or failed record is reported with a reason after the run.
  • 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.