contact-discovery

Contact Discovery

Find people, contacts, and buyer-side context at the right accounts.

Tools In This Skill

AddContactsToList

Add people to an existing contact list.

Accepts Sumble person IDs. Returns how many were added,
how many were already on the list, and the list url.
Duplicates are silently skipped. Always surface the url
to the user so they can view the list in Sumble.

WORKFLOW — when a user provides names or LinkedIn URLs:
1. Call find_people to resolve them to Sumble person
   IDs.
2. Call add_contacts_to_list with the matched IDs
   (use the "id" field from each result).

If you already have Sumble person IDs (from a prior
API call), pass them directly as people_ids.

Args:
    reason: Why you are calling this tool.
    list_id: The contact list ID (from
        list_contact_lists or create_contact_list).
    people_ids: Sumble person IDs to add.

Inputs:

• reason (string, required)
• list_id (integer, required)
• people_ids (array, required)

CreateContactList

Create a new contact list (people list).

Returns the new list's id, name, and url. Always
surface the url to the user so they can view the
list in Sumble. Use add_contacts_to_list to populate
it afterward.

WORKFLOW — when a user wants to build a people list:
1. Call find_people or find_related_people_to_person
   to get Sumble person IDs.
2. Call create_contact_list to make the list.
3. Call add_contacts_to_list with the person IDs.

If you already have Sumble person IDs (from a prior
API call), skip step 1 and use those IDs directly.

Always ask the user for the list name. If you have a
good guess, you can suggest it in the prompt.

Args:
    reason: Why you are calling this tool.
    name: Name for the new list.

Inputs:

• reason (string, required)
• name (string, required)

EnrichPerson

Enrich a person with contact information (email).