> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.polytomic.com/2023-04-25/configuring-your-connections/connections/affinity/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server.

# Affinity

Supports:
* ✅ Models
* ✅ Model sync destination
* ✅ Bulk sync source
* ✅ Connection Proxy




## Connection

### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>api_key</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">API key</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>enable_webhooks</code></td>
<td><code>boolean</code></td>
<td style="vertical-align: top;">Enable Affinity webhook updates for bulk syncs</td>
<td><code>false</code></td>
</tr>
</tbody>
</table>


#### Example

```json
{
  "name": "Affinity connection",
  "type": "affinity",
  "configuration": {
    "api_key": "******",
    "enable_webhooks": false
  }
}
```

### Read-only properties
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>user</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">User</td>
<td><code>false</code></td>
</tr>
</tbody>
</table>


## Model Sync
### Source
#### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>object</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Object</td>
<td><code>true</code></td>
</tr>
</tbody>
</table>


#### Example
```json
{
  ...
  "configuration": {
    "object": "organization"
  }
}
```

### Target
Affinity connections may be used as the destination in a model sync.
#### All targets

##### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>search_domains</code></td>
<td><code>boolean</code></td>
<td style="vertical-align: top;">Search additional domains when matching organizations<br/><br/>Requires additional API calls to Affinity.</td>
<td><code>false</code></td>
</tr>
<tr>
<td><code>write_null_values</code></td>
<td><code>boolean</code></td>
<td style="vertical-align: top;">Copy null values<br/><br/>Removes the existing Affinity field value when the source value is null. Default fields such as names and email addresses are never cleared.</td>
<td><code>false</code></td>
</tr>
</tbody>
</table>


##### Example
```json
{
  ...
  "target": {
      "configuration": {
        "search_domains": false,
        "write_null_values": false
    }
  }
}
```








## Bulk Sync
### Source
Affinity connections may be used as a bulk sync source. No additional configuration options are required.