Pipedrive logo

Add a Lead (Pipedrive)

Pipedrive → Add a Lead (Pipedrive)

POST/v1/pipedrive-add-lead
texau__pipedrive-add-leadcrm
Run in Studio →Open in MCP
cURL · api.texau.app
84ms
POST/v1/pipedrive-add-lead
{
  "title": "sample-value",
  "person_id": 1,
  "organization_id": "Acme, Inc.",
  "label_id": "sample-value",
  "amount": 1,
  "currency": "sample-value",
  "visible_to": "sample-value",
  "channel": "sample-value",
  "channel_id": "sample-value",
  "expected_close_date": "sample-value",
  "was_seen": true
}
200 Accepted
{
  "ok": true,
  "data": {
    "id": "rec_4f3a91",
    "title": "sample",
    "owner_id": "rec_4f3a91",
    "person_id": "rec_4f3a91",
    "organization_id": "rec_4f3a91",
    "value_amount": 1,
    "value_currency": "sample",
    "expected_close_date": "sample",
    "add_time": "sample",
    "update_time": "sample",
    "visible_to": "sample",
    "label_id": "rec_4f3a91"
  }
}

Creates a new lead linked to a person or organization

Install

Add add a lead (pipedrive) to your MCP client.

Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.

claude_desktop_config.json
{
  "mcpServers": {
    "texau": {
      "command": "npx",
      "args": ["-y", "@texau/mcp-server"],
      "env": { "TEXAU_API_KEY": "..." }
    }
  }
}

Tool name: texau__pipedrive-add-lead

When to use this.

The "Add a Lead (Pipedrive)" action enables users to create a new lead associated with a specific person or organization within the Pipedrive CRM platform. This action requires key input parameters such as the lead's title, person ID, and optional organization ID, allowing for detailed lead management. Additional parameters like label ID, potential value amount, and expected close date enhance lead specificity and tracking. The output includes essential data fields such as lead ID, title, owner ID, and visibility settings, ensuring comprehensive lead information is captured. This action is particularly useful for sales teams looking to streamline lead generation processes, track potential revenue, and manage customer relationships effectively. By utilizing this API action, businesses can enhance their CRM capabilities and improve sales performance.

Try it

Run a sample request.

The response is a deterministic, cached example. No live call, no credits used.

Add a Lead (Pipedrive)

Try it

The name of the lead

ID of a person which this lead will be linked to.

ID of an organization which this lead will be linked to.

Select a lead label.

Potential value amount of the lead.

Select the currency for the lead value.

Response is cached — no live API call.

Response

Output schema.

Every field returned in `data`. Click rows to expand nested objects.

FieldType
  • id
    Id
    text
  • title
    Title
    text
  • owner_id
    Owner Id
    number
  • person_id
    Person Id
    number
  • organization_id
    Organization Id
    number
  • value_amount
    Value Amount
    number
  • value_currency
    Value Currency
    text
  • expected_close_date
    Expected Close Date
    text
  • add_time
    Add Time
    nullabletext
  • update_time
    Update Time
    nullabletext
  • visible_to
    Visible To
    nullabletext
  • label_id
    Label Id
    nullabletext

Integrate

Copy-pasteable snippets.

Real endpoint: https://v3-api.texau.com/api/v1/pipedrive-add-lead. Auth: x-api-key.

cURL · api.texau.app
84ms
POST/v1/pipedrive-add-lead
curl -X POST 'https://v3-api.texau.com/api/v1/pipedrive-add-lead' \
  -H 'x-api-key: $TEXAU_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"title":"sample-value","person_id":1,"organization_id":"Acme, Inc.","label_id":"sample-value","amount":1,"currency":"sample-value","visible_to":"sample-value","channel":"sample-value","channel_id":"sample-value","expected_close_date":"sample-value","was_seen":true}'
200 Accepted
{
  "ok": true,
  "data": {
    "id": "rec_4f3a91",
    "title": "sample",
    "owner_id": "rec_4f3a91",
    "person_id": "rec_4f3a91",
    "organization_id": "rec_4f3a91",
    "value_amount": 1,
    "value_currency": "sample",
    "expected_close_date": "sample",
    "add_time": "sample",
    "update_time": "sample",
    "visible_to": "sample",
    "label_id": "rec_4f3a91"
  }
}

Compose

How this fits a workflow.

The next 2 actions most operators chain after this one.

Add a Lead (Pipedrive)→Get Deals by Person (Pipedrive)→Delete Lead (Pipedrive)

Output

Results land in a TexAu table.

Sample rows below.

Real result preview coming soon.

InputStatusScore
[email protected]valid96
[email protected]risky54
[email protected]invalid12

Workflow

A real example.

Trigger → add a lead (pipedrive) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.

Step 1TriggerNew row, webhook, or schedule.
Step 2Add a Lead (Pipedrive)Pipedrive action runs.
Step 3EnrichWaterfall fills missing fields.
Step 4Push to CRMHubSpot / Salesforce / Pipedrive.

Built for

Who runs this.

GTM EngineerRevOpsAgency

Reliability

Rate limits & reliability.

  • Per-minute limitNo public cap
  • Per-day limitPlan-defined
  • RetriesAutomatic w/ backoff
  • ModeSync

Errors

HTTP status codes.

What each response means and what to do about it.

CodeCauseFix
200 OKAction ran. Data in `data`.Read response.
400 Bad RequestMissing or malformed input.Validate against the input schema.
401 UnauthorizedMissing or invalid `x-api-key`.Re-issue from /api-platform.
403 ForbiddenWorkspace lacks plan tier.Upgrade or contact sales.
404 Not FoundAction key not recognized.Verify the slug.
429 Rate LimitedPer-minute or per-day cap hit.Backoff; reduce concurrency.
500 Server ErrorUnexpected TexAu issue.Retry with backoff.
502 Bad GatewayUpstream provider 5xx.Retry; we surface root cause.
504 TimeoutUpstream slower than maxLatency.Switch to `isAsync` polling.

Pricing

What it costs to run.

Light tier

Pricing tier on /pricing. Per-action credit cost is private.

Related

More Pipedrive actions.

FAQ.

  • Is this real-time?

    Yes. Synchronous actions return in ~1–4 s. Long-running work uses async polling (see status 504 → switch to async).

  • Do I get charged on failure?

    No. Verified failures cost zero credits. Provider miss / 5xx / timeout cascade to the next provider in the waterfall when applicable.

  • Does it work with Claude / Cursor via MCP?

    Yes. Add the texau MCP server to your client config, then call `texau__pipedrive-...` directly.

  • What CRMs can I push results to?

    HubSpot, Salesforce, Pipedrive, Zoho, and GoHighLevel are bidirectional. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.

Run Add a Lead (Pipedrive) in 60 seconds.

Pull your API key, paste the cURL, ship to your CRM.

Start free →Read the API docs