Skip to navigation

Keap

Find and add Keap contacts, and log notes and follow-up tasks during calls.

Your receptionist can recognize callers who are already in Keap, add new callers as contacts, note what each caller wanted, and create a follow-up task for your team. There are two ways to connect:

  • Webhook tools call Keap’s API directly with a Personal Access Token, with no Zapier account and no Zapier task usage.
  • Zapier actions sign in to Keap for you, but each action uses tasks from your Zapier plan.

Use webhook tools unless you’d rather not create a Keap access token.

1

Create a Personal Access Token

In Keap, open the Settings menu and select API Settings. In Keap Classic, it’s under the Profile menu. Add a new key, name it, for example Reception.ai, and copy it right away: Keap shows the full key only once.

Create a Personal Access Token, not a Service Account Key. A Personal Access Token acts as you and can see what you can, while a Service Account Key has admin access to all your Keap data. Delete the key in API Settings if it leaks.

2

Find the IDs to fix

New contacts, notes, and tasks need the ID of the user they belong to, and you can also fix the lead source of new contacts. Run these in a terminal, replacing YOUR_TOKEN, and note the id of each value you want:

curl -H "Authorization: Bearer YOUR_TOKEN" https://api.infusionsoft.com/crm/rest/v2/users
curl -H "Authorization: Bearer YOUR_TOKEN" https://api.infusionsoft.com/crm/rest/v2/leadSources
3

Create the webhook tools

For each tool below, go to Integrations, select Add integration, and choose Webhook Tool. Every tool sends the same header: Authorization (Secret), set to Bearer followed by your token.

Find the caller

FieldValue
Namefind_keap_contact
Description”Find the caller in our CRM by email address or phone number. Use it at the start of a call to check whether they’re an existing client. Pass the contact’s id to the note and task tools.”
MethodGET
URLhttps://api.infusionsoft.com/crm/rest/v2/contacts
Request HeadersAuthorization (Secret): Bearer followed by your token
Query Parametersfilter (string, required, from the conversation): “To search by email, write email== and the caller’s email address, for example email==jane@example.com. To search by phone, write phone_number== and the number’s digits, then ;phone_fields==PHONE1, for example phone_number==5551234567;phone_fields==PHONE1.”
fields (string, fixed value): id,given_name,family_name
page_size (integer, fixed value): 5
Assign to agentsReceptionist

fields keeps the response to each match’s ID and name, so the tool never returns other details saved on the contact.

The AI writes the whole filter, and Keap’s filter can also match by name, city, or a name prefix such as given_name==J*. A caller could talk your receptionist into listing up to five other contacts’ names and IDs, and then adding notes or tasks to them. Add a rule telling your receptionist to search only by the caller’s own phone number or email address, and never to say another contact’s name.

Add the caller

FieldValue
Namecreate_keap_contact
Description”Add the caller as a contact, only when find_keap_contact didn’t find them. Pass the new contact’s id to the note and task tools.”
MethodPOST
URLhttps://api.infusionsoft.com/crm/rest/v2/contacts
Request HeadersAuthorization (Secret): Bearer followed by your token
Body ParametersSee below
Assign to agentsReceptionist
  • given_name (string, required, from the conversation): “The caller’s first name.”
  • family_name (string, from the conversation): “The caller’s last name, if they gave it.”
  • phone_numbers (array, required, from the conversation): “Exactly one item, for the caller’s phone number.” Under Each item, choose object and add two fields:
    • number (string, required, from the conversation): “The caller’s phone number.”
    • field (string, fixed value): PHONE1
  • email_addresses (array, from the conversation): “Exactly one item, for the caller’s email address. Leave it out if they didn’t give one.” Under Each item, choose object and add two fields:
    • email (string, required, from the conversation): “The caller’s email address.”
    • field (string, fixed value): EMAIL1
  • owner_id (string, fixed value): the user ID you noted
  • leadsource_id (string, fixed value): the lead source’s ID, if you want one

Don’t add opt_in_reason to the email address. It marks the contact as opted in to marketing, and a spoken yes may not count as consent where you and your callers are.

The tool always creates a new contact. Keap can also update a matching contact instead, but that can replace the phone numbers and email addresses already saved on it, so this guide doesn’t use it.

Log a note

FieldValue
Nameadd_keap_note
Description”Note what the caller wanted on their contact, before the call ends.”
MethodPOST
URLhttps://api.infusionsoft.com/crm/rest/v2/contacts/{contact_id}/notes
Request HeadersAuthorization (Secret): Bearer followed by your token
Path Parameterscontact_id (string, required, from the conversation): “The contact’s id from find_keap_contact or create_keap_contact.”
Body Parametersuser_id (string, fixed value): the user ID you noted
type (string, fixed value): Call
title (string, required, from the conversation): “A short title, for example: Call from Jane Doe about a quote.”
text (string, required, from the conversation): “What the caller wanted, in a few sentences.”
Assign to agentsReceptionist

In Keap Classic, set type to one of the note types your admin set up, or leave it out.

Create a follow-up task

FieldValue
Namecreate_keap_task
Description”Create a follow-up task for the team whenever you promise the caller a callback.”
MethodPOST
URLhttps://api.infusionsoft.com/crm/rest/v2/tasks
Request HeadersAuthorization (Secret): Bearer followed by your token
Body Parametersassigned_to_user_id (string, fixed value): the ID of the user who handles callbacks
title (string, required, from the conversation): “For example: Call back Jane Doe about a quote.”
description (string, from the conversation): “The caller’s name, phone number, and what they need.”
contact_id (string, from the conversation): “The contact’s id from find_keap_contact or create_keap_contact.”
due_time (string, from the conversation): “When the team should call back, as an ISO 8601 date and time, for example 2026-06-21T11:00:00Z.”
Assign to agentsReceptionist

The owner, the note’s user, and the task’s assignee are fixed values, so new records always go to the people you chose.

Add a rule telling your receptionist to use Keap only to recognize the caller, and never to read a contact’s details back to them.

Select Enable on each tool, then test your receptionist as a new caller who asks for a callback. The contact, a note, and a task appear in Keap.

Option 2: Zapier

1

Connect Zapier

If you haven’t yet, connect Zapier in Reception.ai.

2

Add the Keap actions

In your Zapier MCP server at mcp.zapier.com, add the actions below and connect your Keap account. For each field, either set a fixed value or let the AI fill it in, as listed.

3

Assign the tools

In Reception.ai, open the Zapier integration’s Tools tab, select Refresh tools, and assign each action as listed.

4

Test it

Test your receptionist as a new caller who asks for a callback. The contact, a note, and a task appear in Keap.

Zapier actions

Find the caller

FieldValue
Zapier actionFind Contact
Set in ZapierField: the field you search by, such as email or phone.
Let the AI fill inValue: the caller’s email address or phone number.
Assign toClient

Add or update the caller

FieldValue
Zapier actionCreate or Update Contact
Set in ZapierCheck for Duplicates Using (for example, email), the lead source, the owner, and any tags.
Let the AI fill inFirst name, last name, email address, and phone number.
Assign toClient

Don’t set the contact’s opt-in from a call unless you’re sure a spoken yes counts as marketing consent where you and your callers are.

Log a note

FieldValue
Zapier actionCreate Note
Set in ZapierType, for example a call note.
Let the AI fill inContact Id (from the previous action), Title, and Body.
Assign toClient

Create a follow-up task

FieldValue
Zapier actionCreate Task
Set in ZapierUser Id: the team member who handles callbacks.
Let the AI fill inTitle, Due Date, Description, and Contact Id.
Assign toClient

To start a Keap campaign for new callers, add the Tag Contact action with the campaign’s tag set as a fixed value.

Whichever option you use, add a procedure so your receptionist searches for the caller first and only creates a contact when no match is found.

Limitations

  • This guide doesn’t check availability or book appointments, so your receptionist can’t schedule meetings in Keap. Use the follow-up task instead, or Reception’s own booking with Google Calendar.
  • create_keap_contact adds a new contact every time, and Zapier’s Create or Update Contact only spots duplicates by the field you chose. A caller who isn’t found, or who gives a new email address, may be added twice.
  • With Zapier, each action your receptionist runs uses tasks from your Zapier plan. Zapier currently counts two tasks per successful call; failed calls aren’t counted. When the plan runs out, the actions stop until it resets.

Troubleshooting

ProblemWhat to check
401 from KeapStart the header value with Bearer and a space, and check that the key hasn’t been deleted in API Settings.
400 when adding a contactThe contact needs a phone number or email address, and owner_id must be a user ID from your account.
A Keap action doesn’t appear in Reception.aiSelect Refresh tools on the Zapier integration after adding actions in Zapier.
An action shows Changed and isn’t usedYou edited it in Zapier. Select Update in the Tools tab.
Known callers aren’t foundKeap matches values as stored. Search by email, or store phone numbers in one format.
Notes or tasks aren’t linked to the callerYour receptionist needs the contact ID from the find or create tool, or from Find Contact or Create or Update Contact in Zapier.