AddThisFeature

Pipedrive Deal Creation

Turn a qualified lead or purchase into a Pipedrive person, organization, and deal.

moderate Sales & Marketing Tools

What it adds

A flow that finds or creates the person and organization, then opens a deal associated with both in the configured pipeline.

What your agent is told to do

5
  1. 1

    Resolve the person and the organization first, matching the person on the normalized email and the organization on its domain or name, and only then create the deal that references them.

  2. 2

    Make the three creates a recoverable sequence. Record what succeeded after each step, so a failure at the deal stage resumes from the existing person and organization instead of creating a second set.

  3. 3

    Let an admin configure the pipeline, stage, owner, currency, and how the deal value is derived, and validate every one of those against the account before the mapping can be saved.

  4. 4

    Derive a deterministic deal key from the app record that triggered it, and check for an existing deal under that key before creating one. Repeated events for the same signal must find the deal, not open another.

  5. 5

    Do not resolve stages, pipelines, or users by their display names at run time. Names are edited freely; store stable identifiers and re-validate them, and pause the mapping with a named error when one has disappeared.

Edge cases it handles

8
  • Creating a deal before its person and organization exist leaves orphaned deals with no one to call. Resolve or create both, confirm the associations, and only then open the deal.
  • Pipeline, stage, owner, currency, and value must all be chosen deliberately. A deal dropped into the wrong pipeline at a default stage with no value is invisible in forecasting and will be worked by the wrong person.
  • The same app event fires more than once through retries, webhook redelivery, and user impatience. Without a deterministic key derived from the source record, one purchase opens three deals and inflates the pipeline.
  • Saved mappings reference stages and users that get deleted or deactivated. Detect the missing reference, pause the mapping with a message naming what is gone, and hold events rather than assigning to whatever remains.
  • A partial failure — person created, organization created, deal rejected — must be resumable from where it stopped. Persist progress per step so the retry completes the sequence instead of starting a new one.
  • Rate limits and token expiry both interrupt a multi-step sequence mid-way. Back off and resume from the recorded step, and mark the connection broken when reauthorization is required rather than retrying indefinitely.
  • Organization matching by name is unreliable — punctuation, suffixes, and abbreviations all differ. Prefer the domain, and where the match is ambiguous, create the deal against the person and flag the organization for a human.
  • When the provider is unavailable, the app's own conversion must still complete. Queue the sequence, show its status on the source record, and give operators a way to retry it by hand.

Definition of done

9
  • Person and organization are resolved or created before any deal references them.
  • Repeated events for one source record produce exactly one deal.
  • Pipeline, stage, owner, currency, and value are configured and validated against the account.
  • Deleted stages or deactivated users pause the mapping with a named error rather than defaulting.
  • A partial failure resumes from the last completed step without duplicating earlier objects.
  • Ambiguous organization matches are flagged rather than guessed.
  • The app-side conversion completes and the sync status is visible and retryable.
  • 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.