Affinity
Read and write Affinity lists, list entries, people and organizations (API v1).
OCNORA ships 9 typed Affinity operations and 1 trigger. Each node has a schema-driven form, input and output tables beside its settings, and is pre-flighted by Workflow Health before your first real run. Endpoints not covered by a typed node are called at https://api.affinity.co through the HTTP node with the same credential.
Before you connect Affinity
- Authentication
- API key
- Credential
- the Affinity API keythe API key, or {"api_key": "…"}
- Connection test
- Available: the stored credential can be checked against the provider when you add it. This is not a record that a test was run or passed.
- Prerequisites
- Webhooks are instance-wide: the subscription this creates is visible to the whole Affinity instance and counts against its limit of three. Only its creator (or an admin) can delete it, so keep the connection on the key that registered it. Publishing also needs MANTLE_APP_PUBLIC_BASE_URL set to a URL Affinity can reach.
Prerequisites are taken from the connection notes in this provider’s node contracts; each node’s reference page says which apply to it.
What you can do with Affinity
Operations, grouped by what they do to your data, plus 1 trigger that start a run.
Create and send 3
Read and search 5
Delete and cancel 1
A sample Affinity workflow
- 1Eventtrigger.affinity_eventStart a run when Affinity emits an event (list entry, person, organization, opportunity, note, field value…).
- 2Get Listaffinity.get_listReturn one Affinity list, including the field definitions on it.
- 3Add Entry to Listaffinity.create_list_entryAdd an existing person or organization to a list; Affinity does not allow opportunities to be created this way.
An outline built from this provider’s node contracts, not a recorded run. Each step’s output fields are available to the next in the field picker.
Every node below has a reference page: what it does, the connection it needs, its config fields with types, constraints and examples, and the shapes it emits.
Operations 9
- Add Entry to ListAdd an existing person or organization to a list; Affinity does not allow opportunities to be created this way.affinity.create_list_entry
- Create OrganizationCreate a company in Affinity with its name and website domain.affinity.create_organization
- Create PersonCreate a person in Affinity with their name and email addresses.affinity.create_person
- Remove Entry from ListRemove one row from an Affinity list by its list entry id.affinity.delete_list_entry
- Get ListReturn one Affinity list, including the field definitions on it.affinity.get_list
- List EntriesReturn a page of the rows on one Affinity list.affinity.list_list_entries
- List ListsReturn every list the connection's Affinity user can see.affinity.list_lists
- Search OrganizationsSearch Affinity organizations by company name or website domain.affinity.search_organizations
- Search PeopleSearch Affinity people by email address, first name or last name.affinity.search_persons
Affinity questions
- How does OCNORA authenticate with Affinity?
- With a stored API key credential, shaped the Affinity API key or the API key, or {"api_key": "…"}. A connection test can check it when you add it.
- What can I automate with Affinity?
- 9 typed operations and 1 trigger, each with a reference page listing its config fields and the shapes it emits.
- What if the Affinity operation I need is not listed?
- Call https://api.affinity.co from the HTTP node with the same credential, or describe the step to the AI builder, which asks our team for a typed node when one is missing.
- Are there templates that use Affinity?
- Not yet. Start from a blank workflow, or describe the workflow to Build with AI.
- How are Affinity calls controlled?
- Every call and every run step is audited, runs count against the execution budget, and Workflow Health pre-flights the workflow when you save it.
See your first Affinity workflow run.
Book a technical demo. We add the connection, pick a template or describe the workflow to Build with AI, and Workflow Health checks it before it runs.