Affinity
Bearer Token crmsalesAffinity
What you can do
Section titled “What you can do”Connect this agent connector to let your agent:
- Create create — Create a note on a person, organization, or opportunity in Affinity
- Get get — Retrieve full details of a deal or opportunity in Affinity including current stage, owner, associated persons and organizations, custom field values, and list membership
- List list — List pipeline opportunities in Affinity with optional filters by list ID, owner, or stage
- Search search — Search for people in the Affinity network by name, email, or relationship strength
- Update update — Update an existing deal or opportunity in Affinity
Authentication
Section titled “Authentication”This connector uses Bearer Token authentication. Scalekit securely stores the token and injects it into API requests on behalf of your users. Your agent code never handles tokens directly — you only pass a connectionName and a user identifier.
Tool list
Section titled “Tool list” affinity_add_to_list Add a person or organization to an Affinity list by creating a new list entry. Use this to add a founder to a deal pipeline, add a company to a watchlist, or track a new contact in a relationship list. Provide either entity_id for persons/organizations. 2 params
Add a person or organization to an Affinity list by creating a new list entry. Use this to add a founder to a deal pipeline, add a company to a watchlist, or track a new contact in a relationship list. Provide either entity_id for persons/organizations.
entity_id integer required ID of the person or organization to add to the list list_id integer required ID of the Affinity list to add the entity to affinity_create_note Create a note on a person, organization, or opportunity in Affinity. Notes support plain text content and can be attached to multiple entity types simultaneously. Use this to log meeting summaries, due diligence findings, or relationship context directly on a CRM record. 4 params
Create a note on a person, organization, or opportunity in Affinity. Notes support plain text content and can be attached to multiple entity types simultaneously. Use this to log meeting summaries, due diligence findings, or relationship context directly on a CRM record.
content string required Plain text content of the note opportunity_ids array optional List of opportunity IDs to attach this note to organization_ids array optional List of organization IDs to attach this note to person_ids array optional List of person IDs to attach this note to affinity_create_opportunity Create a new deal or opportunity record in Affinity and add it to a pipeline list. Supports associating persons and organizations, setting the deal name, and assigning an owner. Ideal for logging inbound deals or sourcing new investment targets. 4 params
Create a new deal or opportunity record in Affinity and add it to a pipeline list. Supports associating persons and organizations, setting the deal name, and assigning an owner. Ideal for logging inbound deals or sourcing new investment targets.
list_id integer required ID of the Affinity list to add this opportunity to name string required Name of the opportunity or deal organization_ids array optional List of Affinity organization IDs to associate with this opportunity person_ids array optional List of Affinity person IDs to associate with this opportunity affinity_get_opportunity Retrieve full details of a deal or opportunity in Affinity including current stage, owner, associated persons and organizations, custom field values, and list membership. Use this before updating a deal or generating a deal memo. 1 param
Retrieve full details of a deal or opportunity in Affinity including current stage, owner, associated persons and organizations, custom field values, and list membership. Use this before updating a deal or generating a deal memo.
opportunity_id integer required Unique numeric ID of the opportunity to retrieve affinity_get_organization Retrieve an organization's full profile from Affinity including domain, team member connections, associated people, deal history, and interaction metadata. Use this for deep company diligence or to understand team relationships before an investment. 2 params
Retrieve an organization's full profile from Affinity including domain, team member connections, associated people, deal history, and interaction metadata. Use this for deep company diligence or to understand team relationships before an investment.
organization_id integer required Unique numeric ID of the organization to retrieve with_interaction_dates boolean optional Include first and last interaction dates in the response affinity_get_person Retrieve a person's full profile from Affinity including contact information, email addresses, phone numbers, organization memberships, interaction history, and relationship score. Use this to deeply evaluate a contact before a meeting or investment decision. 2 params
Retrieve a person's full profile from Affinity including contact information, email addresses, phone numbers, organization memberships, interaction history, and relationship score. Use this to deeply evaluate a contact before a meeting or investment decision.
person_id integer required Unique numeric ID of the person to retrieve with_interaction_dates boolean optional Include first and last interaction dates in the response affinity_get_relationship_strength Retrieve relationship strength scores between your team members and an external contact (person) in Affinity. Scores reflect email and meeting interaction frequency and recency. Use this to identify the best warm introduction path to a founder, LP, or co-investor. 2 params
Retrieve relationship strength scores between your team members and an external contact (person) in Affinity. Scores reflect email and meeting interaction frequency and recency. Use this to identify the best warm introduction path to a founder, LP, or co-investor.
external_id integer required Affinity person ID of the external contact to evaluate relationship strength against internal_id integer optional Affinity person ID of the internal team member (optional — omit to get scores for all team members) affinity_list_lists Retrieve all Affinity lists available in the workspace, including people lists, organization lists, and opportunity/deal pipeline lists. Returns list IDs, names, types, and owner information. Use this to discover list IDs before adding entries or filtering opportunities. 0 params
Retrieve all Affinity lists available in the workspace, including people lists, organization lists, and opportunity/deal pipeline lists. Returns list IDs, names, types, and owner information. Use this to discover list IDs before adding entries or filtering opportunities.
affinity_list_notes Retrieve notes associated with a specific person, organization, or opportunity in Affinity. Returns paginated note records including content, creator, and creation timestamp. Use this to review interaction history, meeting summaries, or due diligence logs on a CRM entity. 5 params
Retrieve notes associated with a specific person, organization, or opportunity in Affinity. Returns paginated note records including content, creator, and creation timestamp. Use this to review interaction history, meeting summaries, or due diligence logs on a CRM entity.
opportunity_id integer optional Filter notes by opportunity ID organization_id integer optional Filter notes by organization ID page_size integer optional Number of results to return per page (max 500) page_token string optional Pagination token from a previous response to fetch the next page person_id integer optional Filter notes by person ID affinity_list_opportunities List pipeline opportunities in Affinity with optional filters by list ID, owner, or stage. Returns paginated deal records including stage, value, associated people and organizations, and custom field values. Designed for deal flow monitoring and portfolio tracking. 3 params
List pipeline opportunities in Affinity with optional filters by list ID, owner, or stage. Returns paginated deal records including stage, value, associated people and organizations, and custom field values. Designed for deal flow monitoring and portfolio tracking.
list_id integer optional Filter opportunities belonging to a specific Affinity list ID page_size integer optional Number of results to return per page (max 500) page_token string optional Pagination token from a previous response to fetch the next page affinity_search_organizations Search for companies and organizations in the Affinity network by name or domain. Returns a paginated list of matching organization records including team connections, domain info, and interaction metadata. Useful for deal sourcing and company diligence lookups. 4 params
Search for companies and organizations in the Affinity network by name or domain. Returns a paginated list of matching organization records including team connections, domain info, and interaction metadata. Useful for deal sourcing and company diligence lookups.
page_size integer optional Number of results to return per page (max 500) page_token string optional Pagination token from a previous response to fetch the next page term string optional Search term to filter organizations by name or domain with_interaction_dates boolean optional Include first and last interaction dates in the response affinity_search_persons Search for people in the Affinity network by name, email, or relationship strength. Returns a paginated list of matching person records including contact information and relationship metadata. Ideal for finding contacts before creating notes or evaluating deal connections. 4 params
Search for people in the Affinity network by name, email, or relationship strength. Returns a paginated list of matching person records including contact information and relationship metadata. Ideal for finding contacts before creating notes or evaluating deal connections.
page_size integer optional Number of results to return per page (max 500) page_token string optional Pagination token from a previous response to fetch the next page term string optional Search term to filter persons by name or email address with_interaction_dates boolean optional Include first and last interaction dates in the response affinity_update_opportunity Update an existing deal or opportunity in Affinity. Supports renaming the deal, adding or removing associated persons and organizations. Use this to reflect changes in deal status, team assignment, or company involvement during a pipeline review. 4 params
Update an existing deal or opportunity in Affinity. Supports renaming the deal, adding or removing associated persons and organizations. Use this to reflect changes in deal status, team assignment, or company involvement during a pipeline review.
opportunity_id integer required Unique numeric ID of the opportunity to update name string optional Updated name for the opportunity organization_ids array optional Updated list of Affinity organization IDs associated with this opportunity person_ids array optional Updated list of Affinity person IDs associated with this opportunity