Skip to main content
HTTP API connector An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to https://api.affinity.co and carry the credential the connect dialog asks for.

​
What the skill can do

API connector: 56 actions, as they appear in the skill panel. 28 of them create, change or delete something in affinity; mark those under These actions need approval when you add the skill to an agent.
  • Field management (11): Fields Delete Field By Id, Values Delete Field Value, Fields Create New Field, Persons Retrieve Global Fields, Values Retrieve Change Log, Values Update Existing Value, List Entries Retrieve All Entries, Values Fetch All Field Values, Values Create Entity Field Value, Fields Retrieve All Field Definitions, Organizations Retrieve Global Fields
  • List management (6): Lists Create Structured List, Lists Retrieve Specific List Details, Entries Create New Entry, Lists Retrieve All Lists With Details, Entries Retrieve Specific Entry, Entries Delete Entry By Id
  • Note service (5): Notes Create New Note Entry, Notes Retrieve Note Details By Id, Notes Fetch All Notes With Details, Notes Update Note Content, Opportunities Search Across Pipelines
  • Person management (5): Persons Retrieve Person Details, Organizations Search And Retrieve Records, Persons Create Person Record, Persons Delete Person By Id, Persons Search And Fetch All Records
  • Webhook service (5): Retrieve Subscription Details, Retrieve All Subscriptions, Delete Subscription, Create Subscription Entry, Update Subscription
  • Interaction service (5): Interactions Retrieve Interactions List, Interactions Update Interaction Record, Interactions Delete Interaction By Id, Interactions Create New Interaction Record, Interactions Retrieve Interaction Details
  • Reminder service (5): Reminders Retrieve Reminder Details, Reminders Fetch All Reminders With Details, Reminders Create Reminder With Details, Reminders Update Reminder Record, Reminders Delete Reminder By Id
  • Opportunity management (4): Opportunities Create Opportunity, Opportunities Update Opportunity Details, Opportunities Retrieve Opportunity Details, Opportunities Delete Opportunity By Id
  • Organization management (4): Organizations Create Organization Record, Organizations Update Organization Record, Organizations Retrieve Organization Details, Organizations Delete Organization
  • File management (3): Files Retrieve File Details By Id, Files Fetch All Files From Repository, Files Upload Files With Associations
  • Authentication and rate limiting (2): Limit Provide Usage Stats, Auth Retrieve Caller Identity
  • Relationship management (1): Relationships Fetch Strength Metric

​
Connect affinity

In Xpander Chat, open the agent’s settings, click Add skill, and search for affinity. The connect dialog asks for a connection name and whether the connection is for the Organization (one shared account) or Personal (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person’s own sign-in; see whose credential a shared agent uses. The dialog shows the credential this skill needs and where it goes; the value is stored in the vault and attached at the moment of use. Calls go to https://api.affinity.co.

​
Give an agent the affinity skill

Once affinity is connected, any agent you can edit may be given the skill: open the agent’s settings, click Add skill, and choose affinity. Enable only the action groups the agent needs, and mark the actions that should wait for a named person’s sign-off under These actions need approval. Which skills exist for your organization, and who may add them, is decided by your admins; see Skills.