Upfirst is an AI receptionist that integrates with Pipedrive through Custom Actions (direct REST API calls with an API token) and Zapier. The receptionist can search Persons, Deals, and Leads in your Pipedrive account during the call, then update pipeline stages, log Activities, and create Notes once the conversation is done.

Can Upfirst's AI receptionist integrate with Pipedrive?

Two routes:

• Custom Actions — direct REST calls against api.pipedrive.com. The receptionist can query the ItemSearch endpoint, hit Persons or Deals directly, and write Activities or Notes mid-call or after the call.
• Zapier — post-call automation. A completed Upfirst call can create a Person, advance a Deal stage, or log an Activity through the standard Pipedrive Zapier app.

Auth is a single API token from your Pipedrive user settings. No OAuth app registration required for most setups.

About Pipedrive

Pipedrive is the sales-pipeline CRM used by SMBs to track Deals as they move through stages. The object model is straightforward: a Person belongs to an Organization, Deals belong to People, and Activities (calls, meetings, tasks) attach to all of the above. The Kanban-style pipeline view is the part most reps live in.

For sales teams running outbound and inbound calls in volume, Pipedrive is where every conversation needs to end up. Without a connection between phone calls and the pipeline, Deals get stuck and reps lose track of who needs follow-up.

Pipedrive workflows you can run with Upfirst

Match incoming phone numbers to a Person and the Deals they're on

When a call lands, Upfirst hits the ItemSearch endpoint with the caller's phone number scoped to Persons. The matching Person ID comes back, and a follow-up query pulls the open Deals attached to that Person. The receptionist can greet the contact by name and reference the Deal stage, value, or owner without anyone touching the CRM.

Run live Person and Deal searches during the call

If the caller mentions an Organization name, an email, or a Deal title, the receptionist runs an ItemSearch on the relevant fields and reads back what it finds. Pipedrive's ItemSearch is fuzzy enough to handle "I'm calling about the Johnson deal" or "It's about the new contract we discussed." Custom fields are searchable too.

Log every call as a Pipedrive Activity

When the call ends, Upfirst posts an Activity (type: Call) to Pipedrive. The Activity is tied to the matching Person and Deal, marked complete, and includes the call summary in the notes. The full transcript and recording link can go in as a Note instead, depending on how your reps prefer to read call detail.

Advance Deal stages based on what the caller said

Upfirst pulls structured signals from each call: buying intent, budget mentioned, timeframe, objections raised. Custom Actions can use those values to PUT an updated stage_id on the matching Deal, or POST a new Deal for a Person who didn't have one. A "ready to sign" call doesn't just get logged. The pipeline reflects the new reality.

Pipedrive API operations from Upfirst

The Pipedrive REST API exposes the full pipeline model. Endpoints that matter on a phone call:

• GET /v1/itemSearch with a phone, email, or term — searches Persons, Organizations, Deals, and Leads at once
• GET /api/v2/persons/search for targeted Person lookups
• POST /api/v2/persons for net-new contacts
• PUT /api/v2/deals/{id} to update stage, value, status, or custom fields
• POST /api/v2/deals to create a Deal in the right pipeline and stage
• POST /v1/activities to log the call (type=call, duration, subject, note)
• POST /v1/notes to attach the transcript or summary to a Person or Deal

Connecting Pipedrive to Upfirst

Custom Actions setup

1. In Pipedrive, click your profile picture and open Personal preferences > API. Copy your personal API token.
2. In Upfirst, go to Agent > Custom actions and add a new action.
3. Choose the trigger: When call starts for the phone-number ItemSearch, During call for caller-driven searches, or After call for Activity and Note creation.
4. Set the request. Endpoint example: https://{company}.pipedrive.com/api/v1/itemSearch?term=#{{caller_id}}&fields=phone&item_types=person&api_token=YOUR_TOKEN. Or use Authorization header bearer auth on the v2 endpoints. Reference #{{caller_id}} and any defined variables.
5. Select the response fields the receptionist gets (Person name, Deal title, stage, owner). Run a test. Save.

Zapier setup

1. New Zap. Trigger: Upfirst > Call Completed.
2. Action: Pipedrive. Choose Create Person, Create Activity, Update Deal, or Add Note.
3. Map the call fields to the Pipedrive fields. Pipeline ID and Stage ID matter for Deals.
4. Add Zapier filters so only the relevant calls advance Deals or create Persons.
5. Test against a real call. Turn it on.

A pragmatic Pipedrive setup: ItemSearch on call start to land on the right Person, mid-call Deal lookup if the caller asks about an existing deal, Activity log on call end. Zapier picks up the cases where you want to fan the call out to Slack or another tool in the same flow.